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and thus such scheme provides a control over to RSC 10 to announce only a subset of 
these channels to TMCs 50 via RASs 30. However, if some stations do not want to 
encrypt their contents and session announcements at all, this security model should 
effectively prevent IMCs 50, as well as the nonpaying RASs 30, from receiving the 
5 broadcast from those designated stations. Thus, each RSC 1 0 should maintain a secret 
key, and encrypt all outgoing content so that only a ciphertext stream is transmitted. In 
particular, the concept is to generate a symmetric encryption key at RSC 10, and 
securely distribute this key to a particular RAS 30 upon payment of the required fee. 
There are many ways this key can be distributed to the local stations, as is known to 

1 0 those having ordinary skill in the art. 

The global multicast stream encryption can be extended to RAS 30 as a 
second level hierarchy. Some of the pay-per-listen and/or pay-per-view programs can 
be announced to the local multi-cast addresses in any domain using the encryption key 
so that an appropriate fee collection procedure can be established for the IMCs 50. 

1 5 Any type of encryption can be applied to the audit data of RAS 30, so as to preserve 
the sensitive information such as the secret keys of RSCs 10, the information for the 
pay-per-listen and/or pay-per-view channels, the user accounts, and the payment data. 
The advertising entities can be authenticated so that unauthorized companies could 
not gain access to AMA 40. 

20 In practice, each RAS 30 generates its own Public Key /Private Key 

pair. Each RSC 10 generates an SEK key, and begins transmitting the encrypted audio 
and/or video content. This SEK key should be distributed to the participating RASs 30 
in a secure way so that other RASs 30 (which did not pay) cannot obtain this key. As 
such, the Public Key technology is employed for this purpose. RAS 30 submits the 

25 Public Key to RSC 1 0 along with its payment. Then, RAS 30 receives an Integer ID 
from RSC 10 which is later used to index the SEK distribution list. RSC 10 collects 
the Public Keys from RAS 30 and adds these keys to its SEK distribution list upon 
their payment. 
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h. Logging Mechanism 

One of the purposes of providing a logging mechanism for the system 
and method of the present inventions is to provide a process for the advertisers to 
determine when and on which channels to place their advertisements so as to 
5 maximize their returns on investment, RTCP is well suited for allowing RAS 30 to 
collect user-specific and channel-specific listening information. In one embodiment, 
RAS 30 constantly monitors the number of users receiving the broadcast on each 
channel, as well as the type of content being transmitted (i.e., the advertisements as 
opposed to the real content). This is especially advantageous for payment purposes by 

1 0 the advertiser to the local station when the users join or leave the local multicast group 
at the time when the advertisement starts/stops playing. When RAS 30 detects an 
"audience change " (i.e., a change in the number of listeners or the type of content), it 
encapsulates this information into a particular structure, and passes it to the separate 
logging thread for storing into the log files. The logging thread in turn, buffers this 

1 5 information and periodically writes out the contents of the buffer, in a binary format, 
to the log files (using a java serialization). 

The above-described features - i.e., separate logging thread, output 
buffering, and binary (as opposed to text) logs - enable a quick output to avoid an 
interference with the quality of the audio and/or video transmission at run-time. In 

20 addition, these features allow for a good scalability as the number of the receivers of 
the broadcasts increase. A report generation tool can also be used to inspect the log 
files, and generate the statistics in a format that can be presented to the user. Such tool 
may support various commands, such as line options that control the way the tool 
interprets the log and presents its contents to the user. 



25 C, NON-MULTICAST ENABLED NETWORK 

The multicasting environment can be implemented for all segments 
within the system and method of the present invention. Although it may be simpler to 
implement the multicast communication in the Intranet or within an autonomous 
system (e.g., a separate domain), in the past the multicast support between the 
30 autonomous systems has not been readily available. To extend the above-described 



WO 00/79734 



PCT/US0U/I6913 



29 

functionality to a network where the multicast communication is not supported, it may 
be preferable to provide another embodiment of the system and method according to 
the present invention which is based on the user level or the network level application 
level. 

5 I. Multicast Tunneling - Network Layer Solution 

If there is a lack of the multicast connectivity between some portions of 
the network, the multicast connectivity can still be used by establishing a multicast 
tunnel between two different networks using the edge routers. In order to establish the 
multicast tunnel, it is preferable to provide at least one server running a multicast 
10 routing daemon in each such network. However, since this approach is a network layer 
solution, it may also be preferable if some of the hosts would be running the multicast 
routing daemon. This approach may also assume that there is a mutual understanding 
(i.e., interconnectivity) between several connectivity providers. 

II. UDP servers - User Level Solution 

1 5 It may be easier to implement the multicast communication within the 

Intranet. Since the multicast communication is not yet widely deployed over the wide 
area network (i.e., some of the intermediate routers may not support the multicast 
communication), the multicast connectivity between portions of these autonomous 
systems may not currently exist. Figure 10 shows an exemplary configuration where 

20 there is no multicast connectivity in the wide area network, but the multicast 
communication is enabled within the local area. Thus, there may be islands of 
multicast enabled networks, but there may not be any multicast connectivity between 
the islands. In this exemplary configuration, a UDP Server 550 is provided. This UDP 
Server 550 is co-located with RAS 30. It is also possible that its functionality is 

25 provided in the Management Server 200. This UDP server 550 can use a modified 

version of "rtptrans" which allows a conversion of the audio and/or video stream from 
the multicast network type to the unicast network type, and vice-versa, "rtptrans" is a 
conventional RTP translator application which copies RTP packets from any number 
of unicast and multicast addresses. Alternatively these servers can use "UDP Multicast 
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Tunneling Protocol" (UMTP) which can set up a connection between the multicast 
enabled islands by tunneling multicast UDP datagrams inside unicast UDP datagrams. 

In particular, whenever any radio station wants to announce its program 
to the Internet, or if any system wants to broadcast content to the Internet, these 
5 devices register with the nearest antenna server. This can be done as described above, 
where each broadcaster will send its announcement on a specific multicast address in 
the local domain, and RAS 30 will receive the announcement through SAP. Each 
RAS 30 is responsible for maintaining a database of the program profile of the set of 
radio stations announcing in the same domain. If there is no multicast connectivity 
1 0 between antenna servers over the wide area network, then RASs 30 would update each 
other's program schedules which can be categorized according to, e.g., the News type. 
Thus, at any point in time, each RAS 30 will have the program schedule of all RSCs 
10 broadcasting globally, in addition to its own local program if RAS 30 is 
broadcasting the local program. 

1 5 III. Utilization of UDP Multicast Tunneling Protocol (UMTP) 

In order to extend this multicast connectivity to all the autonomous 
systems, LTDP servers that execute the convention UDP Multicast Tunneling 
Protocol can be implemented for a use with the system and method according to the 
present invention. For example, the UDP Multicast Tunneling Protocol establishes a 

20 connection between two end-UDP servers by tunneling the multicast UDP datagrams 
of the respective domain inside unicast UDP datagrams. Each UDP server is located 
within the autonomous system and that autonomous system is multicast capable. In 
this case, both the end points of the tunnel act as masters. Whenever a tunnel endpoint 
- whether a master or slave - receives a multicast UDP datagram addressed to a, e.g., 

25 group, port, etc., that is currently being tunneled, it encapsulates this datagram, and 
sends it as a unicast datagram to the other end of the tunnel. Conversely, whenever a 
tunnel end-point receives, over the tunnel, an encapsulated multicast datagram for a 
group or port of interest, it decapsulates it and resends it as the multicast datagram. 
Each UDP server in an autonomous domain listens to the local 

30 common multicast address to find out the announcement within its domain, and passes 
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it to the other UDP servers in other domain within an encapsulation. Another UDP 
server, after receiving the local multicast address, decapsulates and announces it on 
the local multicast address in the other domain. These UDP servers keep listening to 
each other periodically to update the announcement status. Thus, at any particular 
5 point in time, each client knows the program status of several programs that are 
playing within various domain. If a client prefers to listen to a particular program 
playing in a different domain, it makes a request on the local common announcement 
bus. The local UDP server receives the request, and passes this request to the 
corresponding UDP server in the proper domain. The remote UDP server sends the 
1 0 encapsulated stream on a unicast address, and the local UDP server sends it on the 
appropriate multicast address in the local domain. It is preferable if there is no 
overlapping of the multicast addresses with those provided in a different zone (e.g., a 
zone provided remote from the zone which provide the information on the multicast 
channel). 

15 IV. RTF Trans 

It is also possible to provide an RTPTrans server which converts the 
multicast stream to the unicast stream, and vice versa. A dedicated RTPTrans server 
can be provided in each area. Alternatively, the RTPTrans server can be apart of RAS 
30. For example, the RSCs 10 in the local area transmit programs to the specified 

20 multicast addresses, and send their announcements to the common multicast address. 
The local RTPTrans server listens to these announcements, and send them to other 
RTPTrans servers located in different areas, where the announcements are transmitted 
to the common multicast announcement address in that specific area. Thus, when RAS 
30 listens to the common multicast address using SAP, it can obtain the program 

25 listing of RSCs 10 in other areas, in addition to the listing in its own area. The 

RTPtrans server receives the unicast audio and/or video stream from each RSC 10 via 
other RTPtrans server, and multi casts it on a specific multicast address corresponding 
to the remote radio station. 
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D. MOBILITY MANAGEMENT 

Another embodiment of the system and method according to the 
present invention provides a Mobility Management (MM) technique. This technique is 
especially preferable when IMCs 50 are mobile and wireless. Thus, e.g., area 1 may be 
5 covered by one RAS 30 provided one subnet, and area 2 may be covered by a second 
RAS 30 provided on another subnet. As the mobile and wireless IMC 50 moves from 
area 1 to area 2, it is essential for the mobile IMC 50 to continue receiving (i.e., 
without significant interruptions) the broadcast it was receiving from RAS 30 
covering area 1 . As shall be described in further detail below, one way to accomplish 

10 such uninterrupted broadcast is to imitate the streaming of the broadcast that the 

mobile IMC 50 has been receiving in area 1 into area 2. RAS 30 in area 2 should have 
adequate information about the mobile IMC 50 traveling into area 2 so that it can now 
begin streaming with virtually no perceived discontinuity in the broadcast to the 
mobile IMC 50. Provided below is a description of possible approaches to address the 

1 5 triggering of the multicast streaming in the wireless environment when the mobile 
IMC 50 moves from one subnet to another. 

As described above, each RAS 30 may have two interfaces having 
respective addresses, one can be a global address and other maybe a local address. It 
is also possible to utilize one interface for both address configurations. As shown in 

20 Figures 1 1 A and 1 IB, symbols la. Ib, Ic represent globally known subnets (e.g., 

globally addressable subnets) connected to one of the interfaces of respective RAS 30, 
while symbols ia, ib, ic represent the local subnets (or cells) connected to the 
secondary interfaces of RAS 30, and could be local to that particular area.. 

In operation, RAS 30 receives the multicast stream through its global 

25 interface and redirects it out through the local interface for IMC 50 in each cell. In the 
exemplary implementation shown in Figures 1 1A and 11B, symbols SI, S2 ... S5 
represent servers (or RASs 30) which are connected to upstream routers. Each server 
(with the exception of S2 and S3 which are connected to the same subnet via a 
multicast switch) is connected to a different subnet, and to a separate interface. Each 

30 server is assigned to one particular cellular region, which can be a part of a private 
subnet dedicated for the local user. The base stations are not shown in Figures 1 1 A 
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and 1 1 B for the sake of simplicity of the depiction. These base stations can be IP 
based. It is also possible for the servers to behave as the base stations on one of its 
local interfaces (e.g. having dual interfaces). It is also possible to connect the second 
interface of the server to a non-IP based base station (e.g., a layer-2 base station), 
5 which would perform the handoff. In the illustrated implementation, the servers S2 
and S3 are connected to a multicast switch, which then becomes a part of the same 
subnet that can manage the traffic using GSMP. GSMP is a General Switch 
Management Protocol which can be used in multicast transmissions at a switch level. 
Using GSMP, is possible to save the bandwidth of an adjacent cell if both cells are 
10 part of the same subnet. Different exemplary schemes to effectuate the handoff of the 
broadcast when the mobile IMC 50 moves from area 1 to area 2 (i.e., from subnet S3 
to subnet S4) shall be described in further detail below. 

I. Post-Registration 

The post-registration approach is the easiest approach. However, it 

1 5 may take a long time for the same multicast stream to be directed in the new cell. In an 
exemplary scenario, the mobile IMC 50 move to a new cell (i.e. from cell ib to cell 
ic), obtains the new IP address if it is moving to a new subnet, and then sends the join 
query via RTCP or 1GMP scheme. In this case, there may still be a latency during 
hand-off. This latency can be avoided by other schemes described below. 

20 Popularity based spectrum management to address the limits of 

spectrum, e.g., a control mechanism to manage an audio/video stream based on a 
popularity of the program. 

In an implementation of an exemplary embodiment of the system and 
method according to the present invention, the mobile IMC 50 moves to an adjacent 

25 cell (i.e., from cell ib to ic), obtains a new IP address via a multicast address dispenser 
server if it is moving to a new subnet, and sends a "join" message via RTCP or IGMP 
scheme. After the handover, the mobile IMC 50 would continue to receive the 
multicast streaming content in the new subnet if there are other active participants in 
that adjacent cell receiving the content which the mobile IMC 50 wants to receive. If 

30 there is no participants which receive a particular streaming content in the adjacent 
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subnet into which the mobile IMC 50 moves into, then the mobile IMC 50 joins the 
group by itself after receiving the query from the "first-hop" router (e.g., the router to 
which the mobile IMC 50 is directly connected to). 

It takes some time for the mobile IMC 50 to configure itself after the 
5 move, and then join the group. For example, the mobile IMC 50 may wait for 70-75 
seconds to receive the multicast traffic it was previously receiving after a handover. It 
is also possible to use a discovery agent to discover that the mobile IMC 50 has 
moved to another subnet (i.e., the mobile IMC 50 received a new address). This 
determination may triggers the above-described joining scenario. 

1 0 Advantageously, the above-described handover timing can be reduced 

by exploiting a fast reconfiguration and join time using RTCP (via application layer 
triggering). For example, if the adjacent cell is not a new subnet , then the mobile IMC 
50 does not need to be reconfigured. Indeed, the mobile IMC 50 retains its IP address, 
and the triggering procedure can still be activated using RTCP by utilizing a variation 

15 of GSMP. Otherwise, the streaming content would already be flowing in the adjacent 
cell via the multicast communication technique. 

II. Pre-Registration 

Each station (e.g., the servers SI, S2 ... S5) can have multiple 
neighboring stations (i.e., also servers). For each of these station being shared with 

20 another station, it is preferable to issue a multicast announcement (e.g., a multicast 
address), where each station can determine the program subscribed to, e.g., the group 
address used by the mobile IMC 50. Just before IMC 50 leaves (or decides to leave) 
the current cell (a determination which could be based on the threshold value of the 
received signal), this IMC 50 sends an RTCP message to the local server. The local 

25 server then announces this RTCP message to the sharing multicast addresses, where 
the neighboring stations would be listening to in the global space. The neighboring 
stations (e.g., servers) connect to the multicast address, and verify it with the 
information in their own database to determine if this stream has already been 
transmitted (e.g., if the particular group has already been subscribed to). If another 

30 client have been listening to the same stream, then nothing is done. If the broadcast is 
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not being transmitted, then RAS 30 sends an IGMP message to the upstream router, 
and passes the stream to the local cells using a local multicast address, even before the 
mobile IMC 50 moves to the new cell. Thus, a soft hand-off is emulated for the 
associated stream. As soon as the mobile IMC 50 moves to the next cell, it can still 
5 receive the same stream without any interruption. The mobile IMC 50 sends an RTCP 
BYE message to the server as it move away from the previous server. 

III. Pre-Registration with Multicast Agent 

In this scheme, a multicast agent is utilized to take care of the multicast 
stream. The multicast agent can be provided within each router, which sends these 

1 0 streams to the respective global multicast addresses (e.g., for the area where these 
clients are trying to move in) in each subnet for a specific period of time, as 
determined by a timer associated with the subnet. Thus, each neighboring server 
receives the stream irrespective of whether the mobile IMC 50 is moving into that cell 
or not. As soon as the mobile IMC 50 moves into the new cell, it sends an RTCP 

15 signal to alert that the mobile IMC 50 has moved in, thus the timer does not need to be 
triggered. 



IV. During Registration 

In another scheme according to the present invention, this information 
can be passed on, as a part of a registration method. When the mobile IMC 50 moves 

20 in and attempts to acquire the address in the local subnet, it can send the request for 
that stream in its DHCP option regarding the address it has been listening to. 
However, in that case, the server may also be a registration server. Thus, at the time 
of obtaining the IP address from the DHCP server, the mobile IMC 50 can send the 
local multicast address to the server, and depending on whether the server is already a 

25 part of the multicast tree, it would ignore this request or re-join the tree. 

V. Proxy Registration 

Another scheme can deploy a proxy agent in each subnet. These proxy 
agents join the upstream multicast tree on behalf of the servers, even before the 
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mobile IMC 50 moves into the cell. The neighboring proxy server would then listen to 
a common multicast address to determine the impending host's subscribed multicast 
address. 

The foregoing describes exemplary embodiments of the present 
5 invention. Various modifications and alterations to the described embodiments will 
be apparent to those skilled in the art in view of the teachings herein. For example, 
the system and method according to the present invention can also be used for either 
wired or wireless teleconferencing over the Internet using at least in part the multicast 
communication technique. It will thus be appreciated that those skilled in the art will 
10 be able to devise numerous systems and methods which, although not explicitly 
shown or described herein, embody the principles of the present invention, and are 
thus within the spirit and scope of the present invention. 
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CLAIMS 

1 . A method for providing a broadcast of content to a receiver via a 
communication network, comprising the steps of: 

a) receiving the broadcast on at least one global multicast channel; 
5 b) associating at least one local multicast channel with the at least one 

global multicast channel; 

c) connecting the receiver to the at least one local multicast channel; and 

d) routing the broadcast from the at least one global multicast channel to 
the at least one local multicast channel to provide the broadcast to the receiver. 

10 2. The method according to claim 1 , further comprising the step of: 

e) receiving a request from the receiver to receive the broadcast. 

3. The method according to claim 1, further comprising the steps of: 

f) inserting the broadcast into the at least one global multicast channel; 

and 

1 5 g) transmitting the broadcast at the at least one global multicast channel 

from a global server to a local server. 

4. The method according to claim 3, 

wherein the at least one global multicast channel is a plurality of global 
multicast channels, and the at least one local multicast channel is a plurality of local 
20 multicast channels, 

wherein the broadcast is inserted into a first global channel of the global 
multicast channels, 

wherein the first global channel is associated with a first local channel of the 
local multicast channels, and 
25 wherein the receiver receives the broadcast from the first global channel on the 

first local channel. 
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5. The method according to claim 4, wherein the broadcast is inserted into the 
first global channel by the global server, and wherein the global multicast channels are 
received by the local server. 



6. The method according to claim 5, further comprising the steps of: 

5 h) at the global server, inserting a further broadcast of content into a 

second global channel of the global multicast channels; 

i) receiving a request from the receiver to receive the further broadcast 
from the local server; 

j) if the second global channel is not available to the local server, 
1 0 obtaining access for the local server to the second global channel; 

k) after step (i), associating the second global channel with a second local 
channel of the local multicast channels; and 

1) providing the further broadcast to the receiver by connecting the 
receiver to the second local channel and routing the further broadcast from the second 
1 5 global channel to the second local channel. 

7. The method according to claim 1 , 

wherein the at least one global multicast channel is a plurality of global 
multicast channels, 

wherein the at least one local multicast channel is a plurality of local multicast 
20 channels, 

wherein the broadcast is inserted into a particular global channel by a global 
broadcasting device, and 

wherein the broadcast from the global multicast channels are received by a 
local broadcasting device. 



25 8. The method according to claim 7, further comprising the steps of: 

m) inserting a local broadcast into a particular local channel of the local 
multicast channels, the local broadcast being different from the inserted broadcast; 
and 
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n) if the receiver issues a request to receive the local broadcast, 
establishing a communication link for the receiver to the particular local channel to 
receive the local broadcast. 

9. The method according to claim 1 , further comprising the step of: 

5 o) at a predetermined time and using a multicast communication, 

determining a number of receivers which are receiving the broadcast. 

1 0. The method according to claim 1 , wherein the receiver includes an Internet 
Protocol (IP) interface which enables the receiver to receive the broadcast via an IP- 
type multicast communication. 

10 11. The method according to claim 1 , wherein the receiver is wireless, and 

receives the broadcast in a first subnet using a multicast communication, and further 

comprising the steps of: 

p) receiving, from the receiver moving from the first subnet to a second 

subnet, a request to receive the broadcast in the second subnet; and 
15 q) after receiving the request from the receiver, providing the broadcast to 

the wireless receiver in the second subnet using the multicast communication. 

12. The method according to claim 1 1 , further comprising the step of: 

r) stopping a transmission of the broadcast in the first subnet after 
receiving the request from the receiver. 

20 13. The method according to claim 1 , wherein normal content of the broadcast has 
at least one break of respective predetermined duration, and further comprising the 
steps of: 

s) inserting respective predefined content data into the at least one break 
in the normal content of the broadcast; and 
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t) providing the broadcast to the receiver after the respective predefined 
content data is inserted into the at least one break of the normal content of the 
broadcast. 

1 4. The method according to claim 13, wherein the predefined content includes at 
5 least one of an advertisement, a station break announcement, a promotion and other 

pre-recorded content. 

15. The method according to claim 8, wherein the local broadcast has at least one 
break at a respective time and of a respective duration, and further comprising the 
steps of: 

1 0 u) inserting respective predefined content into the local broadcast during 

the at least one break in the normal content of the local broadcast; and 

v) providing the local broadcast to the receiver after the respective 
predefined content of the local broadcast is inserted into the at least one break of the 
normal content of the local broadcast. 

15 16. The method according to claim 13, wherein the particular data includes at least 
one of an advertisement, a station break announcement, a promotion and pre-recorded 
content for global broadcast. 

1 7. A method for providing a respective predefined content to a receiver during a 

real-time broadcast of normal content, comprising the steps of: 
20 - receiving the real-time broadcast of normal content from a remote 

device via a multicast communication, the real-time broadcast including information 

indicative of a respective time and a duration of at least one break in the broadcast of 

the normal content; 

inserting the respective predefined content into the real-time broadcast 
25 during the at least one break in the normal content; and 
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providing the real-time broadcast to the receiver after the respective 
predefined content have been inserted into the at least one break in the normal content 
of the real-time broadcast. 

18. The method according to claim 17, wherein the respective predefined content 
5 includes at least one of an advertisement, a station break announcement, a promotion 

and other pre-recorded content for global broadcast. 

19. The method according to claim 17, wherein the real-time broadcast is received 
on at least one global multicast channel, and further comprising the steps of: 

associating at least one local multicast channel with the at least one 
1 0 global multicast channel; and 

establishing a network link between the receiver and the at least one 
local multicast channel, and wherein the real-time broadcast is provided to the 
receiver by routing the real-time broadcast from the at least one global multicast 
channel to the at least one local multicast channel. 

15 20. The method according to claim 1 7, wherein the receiver is wireless and 

receives the real-time broadcast in a first subnet using a multicast communication, and 

further comprising the steps of: 

receiving, from the receiver moving from the first subnet to a second 

subnet, a request to receive the real-time broadcast in the second subnet; and 
20 - after receiving the request from the receiver, providing the real-time 

broadcast to the wireless receiver in the second subnet using the multicast 

communication. 

2 1 . The method according to claim 1 7, wherein the receiver includes an Internet 
Protocol (IP) interface which enables the receiver to receive the real-time broadcast 
25 via an IP-type multicast communication. 
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22. A method for providing and maintaining a real-time broadcast to a wireless 
receiver on a communications network, comprising the steps of: 

providing the real-time broadcast into the receiver in a first subnet using a 
multicast communication; 
5 receiving from the wireless receiver, moving from the first subnet to a second 

subnet, a request to receive the real-time broadcast in the second subnet; and 

after receiving the request from the wireless receiver, providing the real-time 
broadcast to the wireless receiver in the second subnet using the multicast 
communication. 

10 23 . The method according to claim 22, further comprising the step of: 

stopping a transmission of the real-time broadcast in the first subnet 
after receiving the request from the receiver. 

24. The method according to claim 22, wherein the wireless receiver includes an 
Internet Protocol (IP) interface which enables the receiver to receive the real-time 

1 5 broadcast via an EP-type multicast communication. 

25 . The method according to claim 22, wherein the real-time broadcast is received 
on at least one global multicast channel, and further comprising the steps of: 

associating at least one local multicast channel with the at least one 
global multicast channel; and 
20 - establishing communication to the wireless receiver over the at least 

one local multicast channel, and wherein the real-time broadcast is provided to the 
wireless receiver by routing the real-time broadcast from the at least one global 
multicast channel to the at least one local multicast channel. 

26. The method according to claim 22, wherein normal content of the real-time 
25 broadcast has at least one break at a respective time and for a respective duration, and 

further comprising the steps of: 
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inserting respective predefined content into the real-time broadcast during the 
at least one break in the normal content; and 

providing the real-time broadcast to the wireless receiver after the respective 
predefined content is inserted into the real-time broadcast during the at least one break 
5 in the normal content. 



27. A receiver, comprising: 

a tuner receiving at least one of a radio broadcast and a television 

broadcast; and 

an Internet Protocol-type communication device configured to receive 
10 a real-time Internet Protocol broadcast via a multicast communication, the analog 
tuner being coupled to the Internet Protocol-type communication device. 



28. The receiver according to claim 27, further comprising: 

a switching device coupled between the Internet Protocol-type 
communication device and the tuner, the switching device being switchable between a 
15 first state and a second state, the first state enabling the tuner to receive broadcast 

signals, the second state enabling the Internet Protocol-type communication device to 
receive Internet Protocol type data using the multicast communication. 

29. The receiver according to claim 27, wherein the Internet Protocol-type 
communication device is connected to at least one local multicast channel for 

20 receiving the real-time broadcast from a global multicast channel, 

30. The receiver according to claim 27, 

wherein the receiver is wireless, and the Internet Protocol-type communication 
device receives the real-time broadcast in a first subnet using the multicast 
communication, 

25 wherein, prior to the wireless receiver moving from the first subnet to a second 

subnet, the Internet Protocol-type communication device transmits a request to receive 
the real-time broadcast in the second subnet; and 
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wherein, after transmitting the request, the Internet Protocol-type 
communication device receives the real-time broadcast in the second subnet by 
utilizing the multicast communication. 

31. A method for monitoring a number of receivers that receive a broadcast via a 
5 communication network, comprising the steps of: 

providing the broadcast to at least one of the receivers on at least one local 
multicast channel; and 

at a predetermined time and using a multicast communication, explain how the 
number of the receivers which are receiving the broadcast the number being 
10 determined by receiving information from the receivers indicative of the broadcast 
being received by the receiving. 

32. A device for providing a broadcast of content to a receiver via a 
communication network, comprising the steps of: 

a communication device communicating with at least one global 
1 5 multicast channel to receive the broadcast; 

at least one local multicast channel; and 

a processing device associating the at least one local multicast channel 
with the at least one global multicast channel, and routing the broadcast from the at 
least one global multicast channel to the at least one local multicast channel to provide 
20 the broadcast to the receiver. 
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Unclude oya/socket .h> 

(include <stcio.h> 

iclude <netir.et/in.h> 

.elude <uni£td.h> 



^include <stri«<j.h> 
.nclude <net/i£.h> 
.delude <fcritl.h> 
.nclude <strop-a.h> 
.nclude <pthread.h> 
.nclude <sched.h> 
.nclude •cstdiLO-h> 
.nclude <limts.h> 
.nclude "BA-S.h" 



=xtern •Jint32_c randon32(int type); 

int total_threads = 0; 

int current_3tate„inden = -If 

State *5tate_array; 

int 3erve(_port, multicast_poct; 

int connfd; 



■nain(int argc, char **argv) 
< 

int listen fd, fd; 
int i, n; 

struct socltacidr_in servaddr, cliaddr; 
int led - sieeof (cliaddr) ; 
RequeatPkt *cp,- 

Char buffer[sizeof (RequestPkt] + HAXJ ILENAME : ; 
int otste_indejcf 

if (argc < 3) [ 

printfi ("usage: RAS <RAS port> <multieaat port>\n"); 
exit<l>; 

1 

argv++; 

server_port = atoi <*argv) ; 
argv++; 

multieast_port = acai ( *argv) ; 

stat«_array - (State *) raalloc tsizeof (State! * MAX_STATES) 
for li-0; i<Max_STATE3f { 
state_acMyli-] .valid » FALSE; 

) 

listenfd - socket (AF_INET, SOCK_STREAM, 0) ; 
if (listenfd < 0) ( 

perror ("socket") ; 

exit(l),- 

} 

biero (sservaddr, siieof (servoddr) ) ,- 
servaddr. sin_family - AF_iHETf 
servaddr. sin_addr.s_addr - ht snl ( INRDDELJUJY ) ; 
servaddr. sin_port - aerver_poctj 

if (bind (listenfd, istruct sacKaddr *) iaorvodUe, siseof (aervaddrl) < 0) { 

£ 5 U 5 
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perror ("bind"); 
exit {1)1 

I 

if (listen llistenfd, 1024) < 0) ( 
perror ("listen*)? 

exitd) ; 

\ 

connfd - accept (listenfd, (struct sockaddr *) scliaddr, ilen) ; 
if (conned < 0) { 

perror ('accept"); 

exit 11) ; 

> 

rp - (RequeatPkt *) buffer; 

while I TRUE) { 

printf (" \ n "> f 

if ( (n » readlconnfd, rp, MAX_REQUE5T_LENGTH) ) <- 0) { 
perror ("read") ; 

ford = 0; i <= current_state_index; i++) ( 
if (atate_array (i) .valid) ( 
atopd) ; 

) 

> . f 

exi-.(l]; :: 

> 

// if (n — 0) continue; 

ford =■ 0; i < 12; it-H I 
printf ("%x\n", bufferd)); 

printf ("RAS; main: m_addr=%x, lm_addr=%x\n", (uint32_t) rp->m_addr, 
(uint32_t) rp->lm_addr) ; 



state_index =» £indLH(rp->Lni_addr| ; 

switch (rp->request_type] { 

case P1AY: 

print f <"FLAi\n") ; 

sendStatus(play (state_index, rp->m_addr, rp->lm_addr) ) ; 
break; 

case COMMERCIAL: 
printf <»COMM\n") ; 

print £<"atate_indejt-%d, path_lenqth-%d, path-%s\n", 
atate_index, rp->path_J.ength, rp->path) i 

sendStatus (commercial (3tate_index, rp->path_length, rp->path)) ; 
break; 

case LOCftl^LA*: 

printf ("LOCAL PIAY\n")? 

printf < "path^length-td, path»%s\n", 
rp->path_length, rp->path) ; 
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sendStatus (localFlay (ip->lnuddr, rp->path_length, rp->path) ) ; 
break; 

ease STOP: 

printf ("STOP\n") ; 

if (state_index < 0) sendStatus (ERROR); 
else stop I state_index) ; 
sendStatua (OK) ; 
break; 

default; 

printf ("ERROB\n") ; 
sendStatus ( ERROR} ; 

> 



Lnt f indNew index 0 
< 

int i; 

printf ("f indNewIndex () : total_treads=%d, currant_state_index-*d\n", 
totaL_threada, current_state_index) ; 

if <current_state_index == total_threads - 1) { 
if (current_3tate_index +■ 1 MMC^STAIES) { 
printf ("findWewIndexlO : returning -1 \n") r 
return -1; 

) 

else < 

printf <"findNewIndex2 <) : returning %d\n", current_state_index + 1); 
return ++current_state_index; 

} 

) 

else 

for' (i»0; i<=current_state_index; i++) { 
if (! state_array[i] .valid) ( 

printf ("f indNew!ndex3 () : returning *d\n", U; 
return i; 

) 

printf ("findNewIndexO : impossible! ! !\n"| ; 



int findLM (uint32_t lm_addr) 

{ 

int i; 

foe <i»0; i<-eurrent - stat#_J.ndex; i++) { 

if {state_array [i] .valid it state_array[il . lm_addc — lm_addr) ( 
printf < " findLM < ) : returning index %d\n", i) ; 
return i; 

i 

) 

printf ("fxndLMO : returning -l\n"); 
return -1; 

} 

int commercial (int state_index, int path_length, const char *path> { 
FILE *fdf 



printf ("commercial (state_index"*d, path_length«%d) \n". 
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state_index, ^Eth_length) ; 

if (state_indcx — -1 ) | path_length <- 0) return ERROR; 

if (3tate~array [stat«_index] . f d) fclose <state_array (state_index] . fd) ; 

fd = fopeMpath, "r") ; 
if (fd •*- NULL) { 

printf ("commercial O : error opening file\n"); 

return ERROR; 

\ 

state_array [state_index] . f d - fdj 

state_array [state_index] . request_type - COMMERCIAL; 
return OK; 



i.it localPLay (uint32_t ln_addr, int path_length, const char *path) ( 
FILE *fdf 

mt 3tate_index, status; 

printf CLocalPlay (path_length=ld, path-%s\n", 
path_length, path I ; 

if (path_length <= 0) return ERROR; 

fd - fopsnlpath, "r")f 
if (fd — NULL) ( 

printf ("localFlay 0 : error opening file\n")f 

return ERROR; 

} 

atate_index - f indNevIndex I ) ; 

if (state^index — -1) return STATES_FULL; 

/* create new atate entry */ 
state_array [state_index] .fd - fd; 

state^array [ state_index| . request_type ■ LOCAL_PLAY; 
state_array [state_index| .m_addr ■ NULL; 
state_arrsy[state_index| .li»_addr - lm_addr; 
state_array [3tate_index] .valid - TRUE; 

tot al_t are ad s++ ; 

/* create a new playing thread (using old state entry) */ 
if ( (status - 

pthrcad_create (t (stat«_array [stata_index] . tid) , 

NULL, processRequest, (void *} state_ind«x) ) !- 0] { 
printf ("play2: can't create thread: error I %d\n", status); 
exit(l); 

} 

return OK; 



void sendStatus (uint6_t status) 

( 

uintS_t a » status ; 
write (connfd, *s, 1); 

\ 

void *proceasRequest (void* index) 
i 

struct ip_jnreq rareq_jn, rnxeq_ln>; 



4 



WO 00/79734 PCT/LS00/I6913 

aAS, c Thti Jua 17 14:|£14 : 9»J 3 

struct sockadd-C_in ain_m, sin_Lra; 
int soc*_ni— 1, sock_lm; 
int numread; 
rtp_packet *rp; 

char buffer {MAX_PAYLOAD_SIZE 1- F IXED_PKTLENGTH ] ; 

char payload_buf lMAX_PAYLOAD_srZE] ; 

FILE *f d; 

uintl6_t seq; 

uint32_t ssrc, ts; 

int lastPlaySaqM), numAdSeq«=0; 

uint32_t state_ir.dex = (uint32_t) index; 
uint32_t m_£ddt = state.atlay [state_index| ,m_addr ; 
uint32 t im_addr - state_array [ at ate_index] . lm_addr; 
int addr_len = sizeof (struct sockaddr_in> ,- 

print frin P rocessRequest(index=*d) m_addr - %x, Lm_addr = *x, «nilticast_port-%d\n\ state_ 
ir.dex, m_addr, Lm_addr, multicast_port) ; 

if (state_array (state_index] .request_type !■ LOCAL_PLAY) { 
mreq_ra.imr_niultiaddr.=_addr = htonl (m_addr) ; 
mreq_m.imr_interface.s_addr = htonl (IHADDR_ANVI ; 

ifllsocX.m = socket !AF_INET, SOCK.DGRAM, 0) ) < 0) < 
per ror ("socket") ; 
exit (1); 

\ 

if (setsockopt (sock_m, IPPR0T0_IP, IF_ADD_MEMBERSHIP, (char *)6rareq_m, ,* 
siieof (struct ip_mreq|) < 0) ( t : 
perrorl'setsoeicopt sockjn" I ; 
exitll] ; 

\ 

sirui.sin_addr.s_addr - htonl (n^addr) ; 
sin_m. s±n_port = htona (multicast_port) ; 
sin_m.sin_family - AF_INET; 

if (bind(sock_jn, (struct sockaddr »)43in_m, aizeof (ain_ni) ) < 0) ( 
per tor ("bind") ; 
exit (II; 

if <fcntl(sock_jn, F_SETFL, 0_SDELAY) < 0) { 
perror ("fcntl") f 
exit U> ; 

) 



} 

mreq^lm.imr_raultiaddr.a_addr - titonl (ln_addr) ; 
mreq_lra.imr_int6£face.s_addr - htonl <lNADDR_ J Mre) ; 

if (<sogk_lm - socket <AF_INET, SOCK^DGRAM, 0) ) < 0) ( 
perror( "socket"); 
exit(l) ; 

> 

if (setsockopt (sock_lm, IPPROTO_IP, rP_jU3D_MEMBERSHIP, (char *)Sroreq_lm, 
sizeof (struct ip_jnreq) ) < 0) { 
perror ("setsockopt sock_lm»); 
exit(l); 

sin_lra . sin_addr . s_addr - htonl ( Lauaddr > ; 
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sin_Lm , sin_port = Mt3Rs Imulticastjsort) ; 
5in_Lm. sin_family = AF_IHE1; 



if (bind (sock_lm, (struct sockaddr *)4sin_lm r sizeof ( ain_lm> ) < CI) { 
perror ("bind") ; 
exit(l); 

} 

/* we want the call to recv t* be non-blocking */ 
if (fcr.tL (sock_lm, F_SETFL, 0_NDELAY) < 0) ( 

perrorCfcntl") ; 

exit(l); 

I 

printf ("processRequest ( incex-%d) : request_type=%d\n", 

state_index, state_array | state_index] . ceq ueat_type) ,- 

while (TRUE) { 

switch [state_array [state_indejc] .request_type) i 
case PLAY: 

/* -heck whether there is information on the socket */ 
numread - recv (sock_m, huffer, sizeof (buffer) , 0) ; 
if |numread>0) { 

rp = (rtp_packet ■*) buffer; 

l£ l2bs(ntohl(rp-?RTP_header.3eq) - lostPlaySeq) >- numAdSeq-1 ) ( 
lastPlaySeq - ntohl ( rp->RTP_header • seq) ; 
numAdSeq - 0; 

if (sendto{3cc]i_lm, buffer, numread, 0, (struct sockaddr •) 4Sin_lra, ' sizeof (at£ 
¥ ct aockaddr_in) ) < 0) { 

pecror<"sendto") ; 
exit(l); 

I 

> els« < 

printf ("Oimiiting an old packet\n" > ; 

} 

} 

break; 

case COMMERCIAL; 
case LOCAl_PLAi: • 

/* default action after we finish the commercial */; 

/* atate_arcayt3tate_indexj .reqi)C3t_typ« - PLAY; */ 

3 arc = randora32 (1) ; 
seq - 0; 
ts - 0; . 

fd - atate_array [st*ta_ind*x] .fd; 
while (TRUE) { 

if (state_arcay[state_index] .requ«st_t/pe !- COMMERCIAL 44 

state_array[state_index] .requeat_typ« !- LOCAl_PLAi) 
break; 

numread - fread <payload_buf , 1, H*X_PAYLOAD_SIZE, fd) f 
if (numread <» 0) ( 

fseeMfd, 0, SEEK_SET) ; 

continue; 

) 

rp =■ (rtp_packet *) buffer j 
rp->RTP_header. version - RTF_VERS ION; 
rp->RIP_head©r.p - 0; 
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cp->RTP_heoder.x - Of 
rp-?RTPJieader . cc = Of 
rp->RTP_header.pt - 0; 
rp->RTP_header . seq » htoril (seq) ; 
rp->RTP_header .ts - htar.l(ts); 
r p->RTP_header . ssrc =■ htonHssrc) ; 
rp->payload_len * htonl I numread) ; 
meracpy {xp->payLoad, paylaad_buf, numread); 

if (sencto<soek_lm, buffer, FIXED_PKTLZNGTH + numread, 0, (struct sockaddr *)Ssin_lrn, 
izeof (struct sockaddr_in) ) < 0) ( 
percor ( "sendt o" ) : 
exit 1 1) ; 

\ 

if (ts >= UINT_MAX - nunread/8 II seq >= USKRXJMAX - 1) { 
seq = 0; 
ts - 0; 

} 

else { 

se<jt-+; 

ts i-= numread/ 8; 

> 

numAdSeq++; 

usleep ((numread/B - 101 * 1000); 
/* yield to another thread */ 
3Ched_yield () ; 

) 

break; ; * 

default: /* either STOP or unknown request status */ 
if <sock_jn >- Q> 
close (sockjn) ; 
close <eock_lm) ; 

stat e_ar coy [atate_index | .valid » FALSE; 

printf r^rocessFequest(index=%d) : request_type=*d . Returning NULL. \n , 
state_index, state_array [state_index] .request_type) ; 

return NULL; 
} /* switch */ 

sched_yield O ; 
} /* while (true) */ 



} 



int play (int state_indejs, uint32_t tn_addr, uint32_t lm_addr) { 
int status? 

printf <"play(state_iindex-*d ...): total_treads-%d, current_state_index-*d\n" 
state_index, total__threads, current_state_index) ; 



/* If we already have an identical M-to-LM binding »/ 
if (state_index !- -1 44 state_array [state_index ] . nuaddr == m_addr) { 
if (state_array[state_index] . request_type — PLAY} { 

print f <-play<state_index=%d ...}: M-to-LM binding already exiatsNn. , 

State_index] ; 
return (DUPLICATE); 

I 

if (state_array[state_index] .request_type — COMMERCIAL) ( 

print f ("play(state_index-%d ...): switching from commercial to play\n , 
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state_array[state_ir.dex] . cequest_type - PV&i 
return OK; 

) 

/* If LM is already being used and M is ciftQrent */ 
if (atate_index !- -1) { 

printf I" play <state_index-%d ...): existing LM, new M\n", 
state_index) ; 

/* NOTE: need synchron i sat ion here •/ 

state_array [ state_index| . request_type = STOP; 

printf [ "play ( ) ■ waiting for thread to terminate\n" ) ; 

while lstate_arrayt3tate_Lndexl .valid) < /* wait for thread to terminate */ 
/* NOTE; can use condition variables here, or pthtread_join ( ) */ 
usleep(lOOO) ; 

} 

printf I "play (> ; thread has terminated. Proceeding ... \n" ) ; 

/* modify the old thread's state entry * / 
state_array [3tate_indes] .m_addr = m__addr; 
state_array lstate_index] .request_type - PLAY; 
state_array[state_indexj .valid «■ TRUE; 

/* create a new playing thread (using old state entry) */ 
if ( (status - 

pthread_create <s [atate_array [ 3tate_index ) .tid), 

NULL, processRequest, (void *) state_index) ) !- 0) { 
printf ("playl : can't create thread: error # %d\n", status); 
exit(l>; 

} 

return OK; 

\ 

/* here, we have a new LM */ 

printf < 'play Utate_index=%d) : new LM\n", 3tate_index) ; 

/* NOTE; also synchronisation needed below */ 
state_index - f indNewlnde* ( J ; 

if {state_index ™ -1) return STATES^ FULL; 

/* create new state entry */ 
state_array [state_index] .n_addr - nLaddr; 
state_array [atat«_index) .lBL_addr - lifl_addr; 
state_array [3tate_index| .request_type - PLAY; 
state_array l3tate_indexj .id - MULL; 
state_array(state_index| .valid » TRUE; 

/* MOTE: synchronize here */ 
total_threads++; 

/* create a new playing thread (using old state entry) */ 
if ((status - 

pthread_create (S (atate_array [state_index] .tidl , 

NULL, processRequest, (void *) atate_index) ) 0) { 
printf ("play2: can't create thrsad! error t *d\n", status); 
exit II); 
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•oid stopdnt state_index) { 
printf Cstop(state_iindex-%d) : total_treads=*d, cur.rent_3tate_i.ndex-%d\n , 
s'tate_index, total_thresds, cur rentes tate„index) ; 

/* NOTE: synchronize */ 

state_array[state_index] . request_type = STOP; 

printf t" stop(state_index=%d) : watting for thread to terminated", 
state_index> ; 

while |state_array(state_index] .valid) { /* wait for thread to terminate */ 
/* NOTE; can use condition variables here, or pthraad_join < ) */ 
usleep (1000) ; 

printf ("stop (5tate_index=%d) : thread has terminated. Cont inuing . . . \n" , 
stata_index) ; 

total_thi:ea.d2 — ; 

if (state_ind«x == current_3tate_index> ( 

while (state_index >- 0 st Istate_array [atate_ind«x— ] .valid) { 
current_state_index — ; 

\ 

} 

\ 
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Ltnport java.io- 
import java.net.*; 
import java . lang , * ; 
import java.ucil . *; 

public class Marconi ( 

private InputStreara is; 
private OutputStream os; 
private Socket sock; 
private HasHtable h; 

public Marconi ( I ( 

h - new Hashtable (> ; 

} 

public static void nam (String args [ ] ) throws Exception ( 
if Orgs. length !- 3) { 

System. cut. println ("Marconi Server demo program: usage: + 

"Marconi <RAS hostname> <RAS port> <RTP port>"l ; 
Syst«™.out.println(*\nRun this program in place of Marconi " + 
"Server, to manually send requests to the Radio Antenna Server.*); 
System. exit (1) ; 



Marconi m = new Marconi (); 



// create a TCP socket for communication with the RK5 

int rtcpEort - Integer. parselnt (args [21> * 1< 

m.sock - new Socket (args [0] , Integer .parselnt (args [1]) > ; 

m.is - m.soek.getlnputStreamO ; 

m.os - m.sock. getOutputStreamO ; 



char choice; 
String command; 
String [] commandArray; 
byte [ I requestPktj 

while (true) ( 

P rcraptUser . di spl ay 0 ; 

choice - PromptUser, get Input () ; 



switch (choice) { 
case ' 1' : // play 
// get M and LM 

comma ndAr ray ■ PronptUser .getFlayCcraraand < ) ; 

System. out .print ("Sending command: "); 

System. out. print In ("PLAY " + commandArray [0] + " " + 

caramandArrayUJ ) ; 
requeatEkt - m. encode Request ( (byte) 1, commandArray 10] , 
commandArray [1] , null); 



m. sendRequest (requestPkt) i 

InsertAd iad - new InsertAd (commandArray, rtcpPort, m> ; 
m. h. put (commandArray [1] « iad); 
iad. start <) ; 

break; 

case '2' : // stop 
// get LM 

command - PromptUser . get StopCommand ( ) ; 
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System. out. print ("Sending command: "); 
System. out . println < "STOP " + corrnand) ; 
requestPkt = m . encodeRequest ( (byte) 2, null, 
command, null) ; 

m. sendRequesc (requestPkt) ; 

InsertAd th - I InsertAd) m.h.get I comnand) ; 
if (th 1- null) < 
th.atopO ; 

m. h . remove (command) ; 

> 

break; 

Cd3e '3': //local play 

CommandArray = PromptUaer . getLocalP layCommand ( > ; 
System. out .print ("Sending commend: ") ; 

System. out. prifttln ( "LOCAL PLAX " + CommandArray i 0 } + " " + 
CommandArray [11); 

Schedule sen » new Schedule (ccnunandArray, m) ; 

sch.3tart () ; 

break; 

case ' e' : 

system. out. prinzln("\n Try again. \n"); 
break; 

case 'q' : 
case 'Q' : 

m. sock. close ( ) ; 

Sy3tem.exit (0) ; 

default : 

System. out. printing Invalid option. Try again."); 
1 // switch 

} // while true 

\ li main 



publi= synchronized void sendRequeat (byte [) requestPkt) 
( 

DyteH statusPkt - new byte[l]; 
Lnt bytaaRead; 

try { 

// send request to the RAS 

03. write (requestPkt, 0, requestPkt. length) ; 

// read th« status returned by th« RAS 

if ((bytesRead- ia.resd(statusPkt> ) < 1) i 

System. err .println ("\nError: status not received. \n" ) ; 

} 

else < 

System. out .print In ("RAS returned 3tatus: ■ 

+■ statu3Heaning (statuePkt [0] I ) ; 

) 

) catch (Exception a) { 

System. out .printLn <e . getMesaage ( I ) ; 

1 

} 
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public byteM encodeRequeat (irt requestType, string m_ada*, 
String lm_addr, string path) 

^ int m = 0/ lm " 0- pathLength = (requeatType ==311 requestType 
4) 7 path. length {) : 0; 

if (nuaddr !- null) m = getlnteqerip (m_addr ] ; 
if (lm_addr !- null) lm - getlntegerlP <lm_addr) ; 

// NOTE: we allocate 1 byte for path even if there's no path 
// (this conforms to the RequestPacket structure of the RA5) 
bytetl buffer - new byte (13 + ((requestType =-311 requestType 
-'4)7 pathLength : 1) ] ; 



buffer[0] = (byte) ((requestType << 16) >>> 24); // requeat_type 

buffer[l] = (byte) ((requestType « 24) »> 24); 

buffer [2] - (byte) ( (pathlength « 16) >» 24); // path_length 

buffer [3] = (byte) < (pathlength « 24) 24); 

II m 

if (requeatType -- 1) ( // play 

bu£fer[4] - (byte) <m 24); II 4 bytes of ra 

buffer [5] - (byte) I (n « 8) >>> 24); 
buffer [6] - (byte) I <m « 16) »> 2 4); 
bufferPJ - (byte) ( (m « 24) »> 24); 

) 

else { 

buffer [4] - 0; 
buffer [5] - 0; 
buffer[6J = 0; 
buffer[7] - 0; 

) 

// lm 

buffer [B] = (byte) (lm »> 24); // 4 bytes of lm 

buffer [91 - (byte) ((lift « 8) >» 24) t 
buffer! 10) - (byte) ( (lm « 16) >» 24); 
bufferlll] - (byte) { (lm « 24) »> 24); 

if (requestType — 3 11 requestType =- 4) { // commercial 
byte[] hytePath - path.getBytes () ; 

for <int i - 0; i < bytePath. length; i++) ( 
buffer!12 + i] - bytePath [i] ; 

\ 

else i U send a zero byte as the path if the path ia empty 
bufcerI12) - 8; 



return buffer; 



private static int getintegerip (String addr) ( 

StringTokenizer st - nam StringTokenizer (addr, *."); 
int ip - 0; 

try '{ 

ip - 
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Int*ger,p4rselnt (at.nextToken () ) 
Integer .parselnt (st -nextToken < ) ) 
I nteger . paraelnt (st . nextToKen I ) ) 
Integer .paraelnt (st . nextTolten lit; 



256 
256 * 

256 t 



256 +■ 



catch (Exception e) \ 

Sy3tem.out.println("getIntegerIP() : error; " + e . getMessage ( ) ] ; 



return ip; 
\ // getlntegerIP 

private static String atatusMeaning (byte 3tatus) i 
switch (status) { 
case 0: return "OK"; 
case 1: return "ERROR"; 
case 2: return "DUPLICATE"; 
case 3: return " STATES_FULL" ; 

default: return " <UWKNOWN_STATUS=" + status + ")"; 
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import java.net.*; 
import ^ava.u^il . 
impart java.io.*; 

public class rnsertAd extends Thread 

private String mAddresa; 
private String ralAddresa; 
private int mPort; 
private Marconi marconi; 
private Ir.etAddreas mGroup; 
private Multicast Socket tns; 
private Vector adList; 
private int laatSeqr 

public static final int pLength = 24; 

public InsertAdl String [] conjnand, int p, Macconi m> { 
mAddress - command[0]; 
mlAddres3 = command [ 1 ] ; 
mFort = p; 
marconi = m; 
lastSeq = -If 
adLiat = new Vector Of 

} 

private int decodelnt (byte [] buffer, int start! { 
int result - 0; 

result 1= ( (buffer [start+31 « 24) »> 24); 
result I- ((buffer [start+2] «: 24) »> 16); 
result I- ( (buffer [start+lj « 24) »> 8); 
result I- (buffer [start] << 24); 



return result; 



public void runt) { 
try { 

mGroup - InetAddress . getByName (mAddress) ; 
ms - new Mult j.castSocket<mPort) i 
ms. joinGroup (mGroup) ; 

Buf feredReader br - 

new Buf feredReader (new Filefteader (mAddreas -t- ".1st") If 



String str; 

whila ( (str - br.readlirwO ) )- null) { 
if <str. equals ("") ) continue 
adLiat . addElement (str) ; 

\ 



br .close 0 ; 

byte [] buffer - new byte [pLength] ,- 
int cur rent Ad ■ 0; 
byte[] requestPkt; 

while (true) { 

Datagram? acket recv - new DatagramPacket (buffer, pLength); 
ms.receive(recv); 

ir.t version - <(buffer[0] « 24) »> 301; 
int subtype - buffer £0] 6 31; 
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int pt = ( (buffer [1] « 24) »> 24); 
short length ■ 0; 

length I- ((buffer [3] « 24) »> 24); 
Length |- (buffec|2| << 8); 

int 3src = decodein- (buffer, 41; 
int cSeq - decodelnt (buffer, 12); 
int remaining = decodelnt (buffer, 16); 
int cLength - decodelnt (buff er, 20); 

/* System. out .println ( "Received pacfcet : * + 
" version*" + version + 
■ subtype-" +■ subtype + 
" pt = " f pt + 
" length"" + length + 
" ssre-" + asre +- 
* aeq-" + cSeq + 
" remaining-* + remaining + 
" cLength=" + cLength) ; */ 

if (version !- 2 || subtype != 1 II length !- pLength/4 - 1 II 
pt !- 204 || | (buffer [6] == ' M' Si buf£er[9] =- 'a' 
s* buffer[101 ™ ' r' 44 buffer[ll] =- 'c')) 

System. out. println ("Received an invalid packet!"); 
continue; 

> 

if (cSeq -- lastSeq) ( 

//System. out. println ("Received a retransmit packet!"); 
continue; 

} 

System. out .print In ("Commercial starting in " + 

remaining + * seconds. Lasting " +■ cLength + " seconds*); 

lastSeq - cSeq; 

Thread. sleep (renaining " 1000); 

requestPkt = marconi .eiicodeRequest ( (byte) 3, null, 

mlAddress, [String) adLiat . elementAt (currentAd) } ; 
marc on i.sendRequeat (request Pkt) ; 

System.out .println ("Commercial ' ♦ 

(String) adLiat . element At IcurcentMl + ■ Started ..."); 
Thread. sleep<cLength * 1000); 

requestPkt - raaxconi .encodeRequest ( (byte) 1, mAddreas, 

mlAddreas, null) ; 
marconi.aendRequaat (requestPkt) ; 

Systea. out .println <".. . Commercial " + 

(String) adLiat .elementAt (currentAd) + ■ Finished"); 
currentAd - (currentAd + 1) % adLiat . size O t 

\ 

) catch (Exception «} { 

e.printStacklrace () ; 

} 

) 

public void Leave () ( 

try { ma . LeaveGroup (mGroup) ; \ 

catch (Exception e) { e.printStackTracaO ; \ 
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} 



} 
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import java.net.*; 
import ^ava.io.*; 
import java.util. *; 
import java . Lang. Math . * ; 

public class IRC { 

* constants defining buffer siaes, etc. 
*/ 

public static final int payloadKBytes =• <!; 

public static final int paylcadBytes ■ payloadKBytes ' 102 4; 

public static final int reset = 50,- 

pubiic static final int maxBuf ferEntriea =■ 500; 



private BufferEntry be; 
private CircBuffer cb; 

private byte I] buffer; 

private boolean newSequence - true; 

private int startSeq; 

private int startTs; 

private long startTime; 

private long current_of f set; 

private int currentSeq; 

private int sarc; 

public IRC () i 

cb = new CircBuffer (maxBufferEntries) ; 

} 



public boolean checkNewSequence (Buf ferEntry ba) ( 

if (newSequence I I Math. aba (be.seq - currentSeq) >- reset 
| | be.ssrc ! =■ ssrc) { 

System . out .println < "NEW SEQUENCE! !!!!!!!!!!!!!!!! L !!!!!!!!!") ; 
return true; 

} 

else return false; 

} 

public void initVarsO { 
startSeq ■ be.seq; 
startTs - be.ts; 
ssrc - be.ssrc; 
Date d = new Dated; 
startTime - d.getTimeO ; 

current_offset - startTirae - startTs + 512 * 20; 
if (newSequence) { 

currentSeq - startSeq; 

} 

newSequence - false; 

^ 

private void decodePacket ( ) < 
int bO, bl, b2, b3; 

be ■=■ new BufferEntry (J ; 

be.v - (buffer (0] « 24) »> 30; 

b0 - (buffer [2] « 24) »> 24; 
bl - [buffer [3) « 24) >» 24; 
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be.s«<i ■ < b0 << 9> I bl; 

bO => buffer[4] ; 

b l = buffer [5]; 

b2 - buffer[6] 

b3 = buffer [7] ; 

bO - (bO « 24) >>> 24; 

bl = (bl « 24) >» 24; 

b2 - lb2 « 24) 24; 

b3 = (b3 « 24) ■>» 24; 

he.ts « (bO « 241 I (bl « 16) I (b2 « 8) I b3; 

bO - buffer [8] ; 

bl = buffer [9] ; 

b2 = buffer [10] ; 

b3 - buffer[ll]; 

bO = <bO << 24) >» 24; 

bl = <bl « 24) >» 24, 

b2 = (h2 « 24) »> 24; 

b3 = (b3 << 24) »> 24; 

be.ssrc = (bO « 24) I (bl « 16) I Ib2 << S) I b3; 

bO - buffer [16]; 

bl = buffer [17] ; 

b2 - buffer [18]; 

b3 - buffer [19]; 

SO = (BO « 24) 2i; 

bl - (bl « 24) »> 24; 

b2 = <b2 << 24) »> 24; 

b3 - <b3 « 24) >» 24; 

be. length - {bO « 24) | (bl « 16) I (b2 « 8) I 63; 

be.paylosd - new byte [be .length] f 
for (int i - 20; i < be. length -t- 2Q; i++) ( 
ae.payloadli - 20] - buffer [i]; 

\ . 



public static void main [String [] args) { 
try { 

IRC ire = new IRCO; 

if (args. length !- 2) \ 

System. out ,println< "Usage : IRC ^multicast addr> <port>») ; 
return; 

> 

String mcaatAddr - args[0]; 

int port « Integer. parselnt (args [1 ]) ; 

// join a Multicast group 

I net Address group - I net Address. get By Name (mcastAddr) ; 
MulticaatSocket a - new MulticastSocket {port) ; 
s . joinGroup (group) ; 

ire. buffer - new byte [payloadBytes + 2D]; 
ire. cb. start () ; 
while (true) { 

DatagramFacket recv - new DatagramPacket (ire .buffer, ire. buffer .length) j ; 
s. receive [reevi ; 
ire . deeodePacket ( ) ; 
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System -out. print Lr (* received packet:" + 
» ae q=« + irc.b«.seq + 

• ts=" + irc.be.ts + 

■ length-" + ire . be . length + 

* ascc" + irc.be- ssrc) ; 

if (ice. checltNewSequence (irc.be)> 
ire .initVar3 <) ; 

irc.currentSeq = irc.be. seq; 

ire. be. offset = irc.current„of fset; 

Date date - new DateO; 
long time = date .getTime [ ) ; 

irc.cb.enqueue(irc.be) ; 



) // while true 

) 

catch (Exception e) ( 

e.printstacklrace () ; 

) 

} // main 
I // IRC 
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import java.io.*: 
import java.net.*; 
import java.lang. *; 
Import java.u^il.*.- 

public class Marconi { 

private InputStream is; 
private Out put St ream as; 
pcivate Socket sock; 
private Hashtable h; 

public Marconi ( ) ( 

h - new Hashtablef) ; 

i 

public static void main(Strirg args [] ) throws Exception < 
if (arg3. length !- 3) { 

System. out. print In ("Marconi Server demo program: usage: " + 

"Marconi <RAS hoatname> <RAS port> <RTP port>") ; 
System. out .println ("NnRgn this programs in place of Marconi * + 
"Server, to manually send requests to the Radio Antenna Server."); 
System. exit (1) ; 

t 

Marconi it. - new Marconi <); 

// create a TCP socket for communication with the RAS 
int rtcpEort ■ Integer .parselnt (args [2] ) +1; 

m. socle - new Socket <args [ 0 1 , Integer . parseTnt (args tl ])) ; , ; 

m.is - m.sock.getlnputStreamO ; 
m.os - m. sock .getOutputStream I ) ; 

char choice? 
String command; 
Stringj] comma ndAr r ay ; 
byte[l requestPkt; 

whiLe(true) { 

EromptUaer . display <) ; 

choice - PromptUser .getlnput () ; 

switch (choice) \ 
case ' 1' t I! play 
// get M and LM 

conunandArray - PromptOser .getPlayConmand <) ; 
Systen. out. print ("Sending command: "); 
Syateii.out.printLn<"PLAY " + conunandArray |0] + " " + 

commandArray [ 1 ) ) ; 
requeatPkt - m.encodeReguest ( (byte) l, conunandArray [0] , 
coiwsandArray [ 1 ] , null) ; 

m.sendRequest (requeatEkt) ; 

InsertAd iad - new insert Ad (conunandArray, rtcpPort, m) ; 
m. h. put (conunandArray [1] , lad); 
iad. start 0 ,• 



cas* '2' : // atop 
fj get LM 

command « PromptUser. getStopCommand () ; 
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System. out .print ("Sending command: "); 
System. out. println ("STOP " + command); 
tetjuestPkt = m.encodeRequest < (byte) 2, null, 
command, null) j 

m.sendRequest (requestPkt) ; 

InsertAd th = ( InsertAd) m.h . get [command) ; 
if (th [- null) ( 
th.atopl) ; 

m.h. cento ve (command) ; 

> 

bteafc; 

case '3'; //"local play 

commandArray = FromptUser . getLocalPlayCommand ( ) ; 
System. out .print ( "Sending command: ">f 

S y stem, out - print In ( " LOCAL PLAY " + commandArray ( 0 J *■ • * + 
commandArray [ 1 ] ) ; 

Schedule sen = new Schedule (commandArray, ra) ; 

sch. start (] ; 

break; 

case ' e' ; 

System. out .println ("\n Try again. \n") ; 
break; 

case 'q' : 
case ' Q' : 

m. sock. close <) ; 

System. exit (0) ; 

default: 

System. out. println (" rnual id option. Try again.") ; 
J // switch 

} // while true 

^ // main 



public synchronized void aendRequest (byte [ J reque9tPkt) 
1 

byte[] statusPkt - new byte[l]f 
int bytesRead; 

try ( 

// send request to the RAS 

03. write (requeatPkt, 0, requestPfct . length) ; 

// read the status returned by the HAS 

if ((bytesRead - is.read(otatusPkt> ) < 1) ( 

System. err. println ("\nError: status not received An") ; 

> 

else { 

System. out. println ( "RAS returned status: • 

+ atatusMeaning (statusFkt [01 ) ) ; 

} 

} catch (Exception e> { 

System. out. println (e. get Message <) I ; 

} 

) 
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public byte[] encodeRequeat (int requestType, String m_adar, 
String lra_Hddr, String path) 

' int ni ■ 0, lni - 0> pathLength = (requestType ==311 requestType 
== 4) 1 path, length <) : 0; 

if (m_addr !- null) m = getlntegerIP (m_addr> ; 
if (lm_addr !- null) lm = get Integer IP (lm_addr I ; 

// NOTE: we allocate 1 hyte for path even if there's no path 
// (this conforms to the RequeatPackat structure af the ras) 
byteU Suffer = new byte [13 +■ ((requestType "311 requestType 
== 4) ? pathLength : 1)1; 



buffer[0; = (byte) ((requestType << 16) >» 24); // request_type 

buffer [Ij = (byte) ((requestType « 24) »> 24); 

buffer [2] - (byte) ((pathLength « 16) »> 24); // path_length 

buffer [3] - (byte) ((pathLength « 24) >>> 24); 

// m 

if (requestType — 1> { // play 

buffer [4] = (byte) <m »> 24); // 4 bytes of m 

buffer[5] - (byte) < (n « 8) i» 24); 
buffet 1 61 ~ (byte) ( (m « 16) »> 24); 
buffer [1] =■ (byte) ( (ra « 24) »> 24); 

) 

else { 

buffer[4] = 0; 
buff art5] - 0; 
buffer [61 = 0; 
buffer [7] - 0? 

> 

// lm 

buffer [BJ - (byte) (lm »> 24); // 4 bytes of lm 

buffer [91 = (byte) ((lm « 8) »> 24); 
buffer [10] - (byte) ( (lm « 16) »> 24); 
buffer [11] - (byte) (<lm « 24) »> 24); 

if (requestType ==311 requestType ™ 4) { // commercial 
byte[] bytePath - path.getBytes < ) ; 

for (int i - 0; i < bytePath, length; H-+) < 
buffer[12 + i] - byteFath[i]; 

) 

else [ // send a zero byte as the path if the path is empty 
buffer[12] - 6; 

\ 



return buffer; 



) 



private static int getlntegerIP (String addr] { 

StringTokenizer st ■ new StringTokenizer (addr, "."); 
int ip - 0? 

try { 

ip - 
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IntegefTparselnt (3t .nextToken O ) * 2 56 

Integer. parselnt < st . nentToken ( ) ) * 256 * «dis& + 

Integer .patseint (st-neyr.TokenO I * 256 + 
Integer. paraelnt (st.nejctTe-KenO ) ." 



catch (Exception e> \ 

System. out .printlnCgetlntegerIP () : error: " t s . getMessage O ) ; 



return ip; 
\ ti getlntegerlP 

private static String atatuaMeaning (byte status! \ 
switch (status) { 
case 0: return "OK"; 
case l: teturn " ERROR" j 
case 2: ceturn " DUPLICATE" ; 
case 3: return " S TfiTE S_FULL " : 

default: return " <UNKNOWN_STATUS-" + status + ")"; 
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import java.net.*; 

import java.util.T 

import java.io-*; 

public class BsSendRTCP extends Thread 

private String mAddresa; 

private int mPort; 

private String acheduleFilej 

private int ssrc; 

private inetAddress mGroup; 

private Mult -cast Socket ma; 

private int cSe<?; 

private Haahtable hTsble; 

public static final byte version = 2; 

public static final int pLength - 24? 

public static final int retransmit - 3; 

public static final byte subtype - 1; 

public static final int maxHash - 7 * 36400; 

public RsSendRTCP {String addc, int p. String file) 
1 

mAddresa = addr; 
mPort = p; 

scheduleFile - file; 

ssrc - (int) < java. lang. Math. random 0 * 10000); 
cSeq - 0? 

hTable - new Haahtable (); 

) 



public void runt) ( 
try { 

mGroup - InetAddress .getByName (raAddress) f 
m9 . n ew Multicastsocket imPort) ; 
ma . joinGroup (mGroup) ; 

BufferedReader br - new Buf feredReader (new Fi leReader (scheduleFilen ; 



String str; 

int lineNum = 0; 

while ((str = br .readLina () ) !- null) { 
linet)um++; 

if (str. equals ("") I continue) 

Stringlokenizer at - new stringTofceniter (atr, " 
if (st.countTolcensU !- 5) I ... 
Syste».err.println<* Illegal number of parameters on line 
+ lineNum + * of " + scheduleFile) ; 

continue; 

} 

int day » Integer .paraelnt Ot.nextToken (>) ; 
int hour - lnt*g«r .parseint (st. next Token (>) ; 
int minute - Integer.paraelntlst.nsxtTokent) ); 
int second - Integer. parselnt(st. nextTokenO ) ; 
int duration - Integer .parselnt (st.nextToken ()) ; 

int hash - day * 86400 + hour * 3600 + minute * SO + second; 

// System. out. println ("Inserting ■ +■ day +■ " " + hour + w ■ + 

fj minute *■ 9 " + second t " • + duration + " " t hash) ; 

hTable. put (new Integer (hash) , new Integer (duration) ) ; 
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br, cl°s e <> ; 

whLLs (true) < 

Calendar myCalendar » Calendar .get Instance () ; 
int day - myCalendar .get ICalendar . DAV_OF_WEEKl ; 
int hour - myCa lendar. get (Calendar. H0UR_OF_DAY> ; 
int minute = myCalendar .get (Calendar. MINUTE) ; 
ir\t second » myCalendar. gat (Calendar. SECOND) ; 
day — ; 

int hash - (day * S6400 + hour * 3600 +■ minute * 6 
second + retransmit * 1) * maxKash; 



(f System. out. printlnCNow is 
I / " " t second) ; 



day 



Integer d; 

if { (d - (integer) hTable. get (new Integer (hash) ) ] !- null) ( 
int duration - d . int Value <) ; 

// create an RICP packet 

byte () buffer - new byte [pLength] ; 

buffer[0) = (byte) (version << 6); // version, p 

buffer!"] |= subtype; // subtype 

buffer [1] = (byte) 204; // pt 

short 1 = pLength/4 - 1; 

buffer {2] = (byte) (1 >» 8); // length (higher byte) 

buffer [3] - (byte) [(1 « 8) »> 3); // length (lower byte) 



// ssrc 
buffer [4] 
buffer [5] 
buffer [6] 
buffer [71 



(byte) (ssrc >» 24); 

(byte) ((ssrc « 8) >» 24); 

(byte) ( (aarc « 16) >» 24); 

(byte) ((astc « 24) »> 24); 



- 'M' ; 



// name 
buffer [8] 
buffer! 9] 
buffer [10] - 'r'; 
buffer [11] - 'C; 



// cseq 

buffer [12] - (byte) (cseq >» 24); 

buffer [13] - (byte) ((cSeq « 8] »> 24); 

buffer [14] - (byte) ( (cSeq « 16) >» 24); 

buffer [15] - (byte) ( (cSeq « 24) >» 24); 

cSeq - (int) ( (CSeq -- 32767) ? 0 : cSeq + 1); 

// length of commercial 
buffer [20] ■ (byte) (duration >» 24); 
buffer [21] - [byte) ((duration « 8) >» 24); 
buff«r(22] - (byte) ((duration «: 16) »> 24); 
buffer [23] - (byte) ((duration « 2 4) »> 24); 

for (int i - retransmit+1; i>0; i — ) { 

If time remaining to commercial 
buffer[16] - (byte) U »> 24); 
buffer [17] - (byte) ( (i « 8) »> 24) f 
buffer [18] - (byte) ( (i « 16) >» 24); 
buffer [19] - (byte) ( (i « 24) »> 24) t 
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System- out .println ( 

"Sendinq alert for commercial break: starting in " + 
i + " seconds, lasting " f duration + " seconds"); 

DatagramPacket dp - new DatagramPacket 

(buffer, pLenqth, raGroup, mPort) ; 

ms. send (dp) ; 

Thread. sleep <10 0 3) ; 

\ 

\ 

Thread. sleep (1000) ; 

i 

\ catch (Exception e) ( 

e .printStackTrace () ; 

} 

public void leave O { 

try { tr.s. leaveGroup (mGroup) ; } 
catch (Exception e) 1 

e.printStackTraceO ; 

) 
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import java.io.*; 

import java.util-'J 

import java . lsng. */" 

import java.text . *; 

public class Schedule extends Thread ( 

private String lmAddresa; 

private Marconi marconi; 

public static String scheduleFila; 

public static int[] dateArray - new int[4] p - 

public Schedule (String [] command, Marconi m) { 
lmAddress - command [Q] i 
scheduleFiie = command [ 1] ,- 
marconi - m; 

} 

public void run ( ) ( 
try ( 

byte [J requestPkt; 
boolean flag; 

while (true! ( 

BufferecReader br = new Buff eredReader (new FileReader (scheduleFile) ) ; 

int[] array - new int{6]; 
String str; 

while ((str - br. readLine <) ) !- null) { t * 
int index =0; ,! 
for (int i-0; i<8f i+-f-) { 

int endlndex - atr .indexOf (' ', index); 

array [i] - Integer .parseEnt (str. substring (index, endlndex) ) ) 
index = endlndex+l; 

String fileName = str . substring (index, atr .lengthO -1) ; 
getCurrentDateO ; 

if (isBetween (array) ) { 
// atart playing 

if [isAddress I fileName] ) flag - false; 
else flag - true; 

System. out. println ("fileName: "+f ileName) ; 
if (flag) 

requeatPkt - marconi . encodeRequest < <byt«) 4, null, lmAddresa, fileName); 
else 

requeatPkt - marconi. encodeRequest ( (byte U, fileName, lmAddress, null); 

marconi. sendRequeat (requeatFkt) t 

I* System. out. println ("now in date range:") ; 

foe (int i-0; i<8; i++) { 

System. out. print (array [i J + ■ ") i 

) 

System. out.printlnO ; 
if (flag] 

System. out .println ("Playing file "+f ileName) ; 
else 

System. out. println( "Redirecting packets from "+f ileNawe) ; V 



while (true) { 

Thread. sleep (1000) ; 
getCurrentDate ( ) ; 
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if ( ! isSetween (array) ) break; 
// stop playing 

requestPkt = marconi .encodeFequest < (bytet 2, null, ImAddress, null); 
marconi . sendRequest (requestPkt) ; 
> // if 

> //while 

> 

catch (Exception e> ) 

System. out. println (e . getMesaage ( ) ) ; 

} 



public boolean isAddress (String str) ( 
int count=0; 
int indexed; 

while ( (index=str.indexaf (' .' , index) I != -1) { 
count++; 
indese4 + ; 

) 

if (count — ■ 3) return true; 
else return false; 



public static void main (String args[]) throws Exception ( 

if (args, Length !- 1) { 

System. out .println ("Usage : Schedule <schedule data file>"); 
return; 

) 

String scheduleFile » arg3[0); 
while (true) { 

BufferedReader br = new BufferedReader (new FileHeader (scheduleFile) > ; 

int[] array - new int [81; 
String Str; 

while < (str - br.readline < ) ) !- null) ( 

int index - 0; 
for (int i=-0? i<8; 1++} \ 

int endlndex - str .indexOf (' *, index); 

array[l] - Integer .parselnt (str. substring (index, endlndex)); 
index - endlndeJU-l; 

} 

String fileName - str. substring (index, str . length () -1) ; 
String localName - "LOCAL* ; 
getCurrentDatfl () ; 

if ( is Bet ween (array) ) ( 

// PLAY 

System. out. println ("current time:"); 
for (int i-0» i<4; iv+) { 

System. out. print <dat«Array[i] + • ") ; 

} 

Syatfltn.out-printlnO ; 

Sy stem . out . pr int In ( »dat a range :■) ; 

for (int i-0; i<8; i++> i 

System. out. print (array (i) + " "); 

} 

System. out .println ( ) ; 

System. out. println ( "Playing file "tfileName) ; 
while (true) < 

Thread. sleepUOOO) ; 
getCurrentDate ( ) I 
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if (! isBetween (array) ) break; 

//'siOF PLAYING 
} // if 
} 

} //while 
I // main 

public static void getCurrentDate <> ( 
Date myDate - new Dated; 

Calendar myCalendar = Calendar .get Instance O ; 
dateArray [0] = myCalendar .get (Calendar .DAV_OF_WEEK) ; 
(JateArray [1 1 ■= myCalendar . get (Calendar . HOUR_OF_DRY) ; 
dateArray [21 ■? myCalendar . get (Calendar .MINUTE) ; 
dateArray [3] = myCalendar . get (Calendar . SECOND) ; 



public static boolean isBetween ( int I ] array) ( 

for (int i=array[0]; ;i=(i+l)*7) { 
if (i == dateArray [0] ) ( 

if (i !- artay[0] Si i !=■ array[4]> 
return true; //between 2 days 

if li — array[Q]) { //sometime on the left boundary day 
if (dateArray [U < array [11 ) // if hour is earlier 
return false; 

if (dateArray [1] ™ array[l]> < // figure out the minutes 
if (dateArray [2] < array [2]) return false; 
if (dateArray [2) — array[2]) ( // figure out the seconds 
if [dateArray [3] < arrayUJt return false; 
if (dateArray [3] — array (3] II array[0] !-array[4]) 
return true? 

\ 

else ir (dateArray [01 !- array [4] > return true; 

I 

else if (dateArray [0] !- array[4]) return true; 

if (i ==■ array[4]> i //sometime on the right boundary day 
if (dateArray [1 J > array [5]) // if time is later 
return false; 

else if (dateArray U) < array[5]) //has already been checked for early 

return true; 
else ( // hours are equal 

if (dateArray [2] < array [6)) return true; 

if (dateArray [21 > array [61) return false; 

//minutes are equal 

if (dateArray [3] > array[7]) return false; 
return true* 

} 

I 

break; 

> 

if (i «- array [41) break; 

} 

return false; 

} 

} // class 
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import java.lang.*; 
impart java.util.*; 
import java.-O.*; 

public class CircBuffer extends Thread 1 
private -ht maxSize; 
private ^nt current Index ; 
private BufferEntryU array; 
private int delay - 100; 

private AudioOut put Stream aoa; 

private int seq = 0; 

private '/old write (byte [] payload) i 
try { 

aos .write (payload, 0, payload . length) ; 

) 

catch {Exception e) ( 

System. out . print Ln le.getMessage () ) ; 

\ 

\ 

public CircBuffer (int maxBu f ferSize) { 
maxSize = maxBuf f erSize; 
currentlndex - 0; 

array » new Buf f erEntry [maxSize] ; 

\ 

public void enqueue (Buf ferEntry be) ( f r 

array (be. seq % maxSize] - be; 

) 

public void incrSeq <) { 

seq - (seq 32767) ? 0 : seq +■ 1; 

\ 

public void run() { 
int i; 

aos - new AudioOutputStreamO ; 

whiLe(true) I 

for (i=0; i^maxSiiej L++) ( 

if (array [seq % maxSize] !- null) { 
break; 

} 

else incrSeqO; 

\ 

if (1 — maxSize) { 
continue; 

} 

ae q * array [seq % maxSize] .seq; 
Date date - new DateO; 
Lang time - date . get Tine O ; 

if (array[aeq % maxSize] .ts + arraytseq \ maxSize] .offset + delay < time) { 

System. err. println(" late packet: ts - " + arraytseq * maxSise] .ts + " current tim 
s - ■ + time +■ " offset - ■ + arraytseq * maxSize] .offset); 
array [aeq % maxSize) - null; 
continue; 
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if (array [seq t maxSize]. ts arraytseq % majtSiie] .offset > tin*) { 
incrSeq() ; 

/ /System. out .println ("Packet * +■ seq t " is too earLy to play") ; 
continue; 



System. err. println ("writing packet: seq=" + seq+ " ssrc=" + array [3eq % maxSize] 
+■ rc + " ts=" + array[aeq % maxSize] .ts| ; 

write (array [seq % maxSize] .payloadl ; 

array [seq * maxSize] = null; 
Thread. yield () ; 

) ft while true 
} // run 

} 
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=lass BufferEntry { 

public int v, ssrc, ts, seq, length; 
public long offset i" 
public byte[] payload; 
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IRC uses Local class promptUaer, which takes care of console input/output. 
It displays a menu, gets user input and displays the return values of 
invoked remote methods. 
«/ 

import java.util-** 
import java.io.*i 

public class Prc-mptUser { 
static String command; 
static Buf faredReader br; 
static String mAddr; 
static String lmAddr; 
static String path; 

I" 

* Display the menu 
*/ 

public static void display O I 

System. out . println (" \n\n Menu "); 

Sy stem. out .println <"1 . play"); 

System. out .println ("2. stop"); 

System. out .println ("3. local play") ; 

System. out. println ("Q. quit"); 

System. out -print ("\nSelect an option; "); 

} 



// read a number corresponding to user's option and convert it to 
// character 

public static char getlnputO < 
char choice - 'e* ; 
try { 

br - new BufferedReader (new InputStreamR«ader (System. in) ) ; 
chciee - (char) br. read O ; 

> 

catch (Exception e) ( 

System. out .println (e . getMeasage () ) ; 

) 

return choice; 

) 



public static String!] getPlayConuiand ( ) ( 
System. out .print ("Enter <K> <LM>: "); 

try! . %l 

br - new BufferedReader (new inputStrearaReader (Syatera.mn ; 
command « br.readiine <) t 

) 

catch (Exception e> { 

System. out .println (e .getMassage () ) ; 

} 

StringTokeniier at = new StringTokeniser (command) ; 
int argc - st . countToltena ( ) ; 
String [] array - naw String [arge] ; 

for (int i-0; Kargc; 

array [i] - st .next Token () } 
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return array; 



public static St ring [] getLocaLFlayCommand ( ) { 

System. out. print* "Enter <LM> < SCHEDULE FILE>: "): 

try{ 

br =■ new Buf feredReader (new inputStreamReader (System. in) ) ; 
command « br, readLine 0 ; 



String!] array =■ new String [2]; 

StringTokenizer st = new StringToxenner (command) ; 

for (int i - 0; st . hasMoreTokens O St i < 2; ( 
arrayfi] = st . nextTofcen ( ) ; 

} 

return array; 



br = new Buf feredReader (new TnputStreamReaderfSyatera.in) ) f 
command = br.readLine () ; 



catch (Exception a) { 



System. out .print In (e . get Message ( 1 1 ; 
> 



public static String getStopCommandO { 
System. out. print ("Enter <1M>: '); 



try! 



catch (Exception e) { 

System. out .print In (e.getMessage () ) ; 



return coramand; 



> 
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/* MD5C-C - FtSA Data Security, inc., MD5 me33age-digest algorithm 
V 

/* Copyright <C) 1991-2, RSA Data security, Inc. Created 1991. All 
rights reserved. 

Licenae to copy and use thia software is granted provided that it 
is identified as the "RSA Data Security, inc. HD5 Message-Digest 
Algorithm* in alL material mentioning or referencing thia software 
or this function. 

License is also granted to make and use derivative works provided 
that such works are identified as "derived from the RSA Data 
Security, Inc. MD5 Message-Digest Algorithm™ in all material 
mentioning or referencing the derived work. 

RSA Data Security, Inc. makes no representations concerning either 
the merchantability of this software or the suitability of this 
software for any particular purpose. It is provided "as is" 
without express or implied warranty of any kind. 

These notices nust be retained in any copies of any part o£ thia 
documentation and/or software. 
*/ 

♦include "global. h" 

♦ include "md5.li" 

♦ include <memor'/.h> 

static char rcaid[) = "Sid: md5c.c,v 1.1 199T/12/17 12:52:36 hgs Exp $«; 

/* Constanta for HDSTransf orm routine. 
*/ 

♦define Sll 1 
♦define S12 12 
♦define 313 17 
♦define S14 22 
♦define S21 5 
♦define 522 9 
♦define S23 14 
♦define S24 20 
♦define 531 4 
♦define 332 11 
♦define 333 16 
♦define S34 23 
♦define S41 6 
♦define S4Z 10 
♦define S43 15 
♦define S44 21 

static void MD 51 r ans form FROTOJUST ( (UIHT4 (4], unsigned char (64])>; 
static void Encode PROTO^LIST 

((unsigned char *, UIHT4 *, unsigned int)); 
static void Decode PROTO_itI3T 

( (UINI4 *, unsigned char unsigned int) ) ? 

static unsigned char PADDING [64] - ( 

0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 
0, 0, 0, 0, 0, 0, 0, 0, 0, Q, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 

}; 

/* F, G, H and I are basic MD5 functions. 



36 



WO 00/79734 



PCT/US00/16913 



mdSc.e 




11:19:51 1»9* 



2 



*/ 



♦ define Fix, y, *) <Hx) S (/> > I ((-*» 5 <*>]> 
♦define GIx, y, z) (Hx) S (z)) I ((y) 4 (-*>>> 
♦define Hi*, y. z> <<x) - < y) - <*)) 

♦ define I !x, y, *) <<y) " (<x) I (-at)) 

/* ROTATE_LEFT rotates x left n bits. 
*/ 

♦ define ROTATE.LEFI <x, n) { < (x) « <nl) I (Ul » (32- In]))) 

/* FF, GG, HH, and II tranafomationa for rounds 1, 2, 3, and 4. 
Rotation ia separate from addition to prevent recomputat ion . 
*/ 

♦define t"F <a , b, c, d, x, s, ac) ( \ 
(a) += F <<b>, (O, (d)> + (x) + (UINT4)(ac); \ 
(a) - ROTME_LEFT ((a), (si); \ 
(a) += ib>; \ 
\ 

♦define GG (a, b, c, d, x, s, ac) \ \ 
(a) +- G ((h), <c), (d)> + (x) + (UINT4) (ac) ; \ 
(a) = ROTATE_LEFT ((a), lS))l \ 
(a) +=■ (b) ; \ 
} 

♦define HH (a, b, c, d, x, s, ac) { \ 
(a) +- H ((b), (c), (d)) * <x) + <UINT4>(ac»; \ 
(a) = ROTATE_LEFT ((a), (3>); \ 
(a) +- {b>; \ 

y 

idefine It (a, b, c, d, x, 3, ac) { \ 
(a) += I ((b), (c), (d)> ^x) + <UtNT4»(ac); \ 
(a) = ROTATE_L£FT ( (a) „ (s)); \ 
(a) 4-- (b); \ 



/* MD5 initialization. Begins an MD5 operatiun, writing a new context. 
*/ 

void MDSInit (context) 



{ 

context->count[0] - context->count [1] - 0; 
/* Load magic initialization constants. 

*/ 

context-estate [0] - 0x67452301; 

context->state[l] - QxefcdabBS; 

context->atate[2] - 0x98bade£e; 

context-estate [3] - 0x10325476; 



/* MD5 block update operation. Continues an MD5 message-digest 
operation, processing another message block, and updating the 
context. 
V 

void MD5Update (context, input, inputLen) 

HD5_CTX "context; /* context */ 

unsigned char *input; /* input block V 



unsigned int i, index, partLen; 

/* Compute number of bytes mod 64 */ 

index - (unsigned int) ( (context->count {0 ] » 3) & 0*3F> i 
/* Update number of bits */ 

if ( (ccntext->count(0] +■- ( (UINT4 > inputLen « 3)) < ( (UINT4) inputLen « 3)) 



} 



MP5_CTX 'context; 



/* context */ 



unsigned int inputLen; 



/* length of input block */ 
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context->cou«t[l] ++; 
context->count [1] ■•— ( (UINT4) inputLen » 29)? 

partLen - 64 - index; 

/* Transform as many times as possible. */ 
if "(inputLen s= partLen) ( 
memcpy 

( (POINTER) 4context->buffer [index] , (POINTER) input, partLen); 
MD5Tcans fozn (context->state, context->buffer) ; 

for (i =• partLen; i + 63 < inputLen; i += 64) 
MDSTransform (context->state, Sinpot[i]); 

index - 0; 

) 

else 

i = Q; 

/* Buffer remaining input */ 
memcpy 

( (POINTER) iconteXt->buf fer : index] , (PO INTER) 4 input [ i ] , 
input Len-i) ; 

) 

/* MD5 f inalizaticn. Ends an MD5 message-digest operation, writing the 
the message digest and zeroizing the context. 
*/ 

void MD5Final I digest, context) 

unaided char digest [16]; /* message digest */ 

MD3_CTX 'context; /* context */ 

< 

unsigned char bits [8]; 
unsigned int index, padLen; 

/* Save number of bits *t 

Encode (bits, context->count , S) ; 

/* Pad out to 56 mod 64. */ 

index - (unsigned int) ( (context->count [01 » 3) i 0x3f); 
padLen = (index < 56) 7 (56 - index) : (120 - index); 
MD5Update (context, PADDING, padLen) ; 

/* Append length (before padding) */ 
HDSUpdate (context, bits, 8)? 



/* Store state in digest */ 

Encode (digest, context->state, 16) ; 

/* zeroise sensitive information. V 
memset { (POINIER) context, 0, aiieof (*context)); 
) /* MDSfinal */ 



/* MD5 basic transformation. Transforms state based on block. 
*/ 

static void MDSTransform (state, block) 
UINT4 state [4|; 
unaigned char block [64 J; 

{ UINI4 a - state [0], b - atate[l], c - atate[21, d - stat«[3], x[16]; 
Decode (x, black, 64); 
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/* Round 1 */ 

FF (a, b, c, d, x[ 0], sil, 0xd76ae47B) ,- /* 1 */ 

FF (d, a, U, c, x[ 1], si 2r 0xe8c7b756); /* 2 */ 

FF <c, d, a, b, x[ 2], 313, 0x242070db> ; /* 3 V 

FF (b, c, d, a, x[ 3]-, S14, Oxclbdceee); /* 4 */ 

FF (a, b, e, d, x[ 4], sil, Ox£b7c0faf); /* 5 '/ 

FF (d, a, b, c, xt 5], S12, 0n4737c62a>; /* 6 '/ 

FF (c, d, a, b, x[ 6], S13, 0xa8304613) j /• 7 */ 

FF (b, c, d, a, x[ 7], SL4, 0xfd4695Ol) ; /* 8 V 

FF (a, b, c, d, xl 8], SU, 0x698098d8>; /* 9 */ 

FF (d, a, b, c, x[ 9], S12, 3x8b44f7af); /* 10 V 

FF (c, d, a, b, x[10], 513, Oxf f f f 5bbl> ; /* 11 */ 

FF (b, c, d, a, x[ll], S14, 3x895ed7be); /* 12 */ 

FF (a, b, c, d, x[12], Sil, 0x6b9OU22); /* 13 V 

FF (d, a, 5, c, x[13], S12, 0xfd987193) f /* 14 */ 

FF (c, d, a, b, x[14], 513, 0xa679438e> f /* 15 */ 

FF (b, =, d, a, x[15], 314, 0x4 9b4 0821 ) ; /* 16 *t 

/* Round 2 */ 

GG (a, b, d, x( 1], 521, Oxf 61e2562) ; /* 17 */ 

GG (d, a, b, c, x[ 6], 322, 0xc040b340); /* 18 */ 

GG (c, d r a, b, x(ll], 523, 0x265e5a51) ? /* 19 V 

GG (b, c, d, a, x( 0], 324, 0xe9b6c7aa) ; /* 20 V 

GG (a, b, d, xt 5], 321, Oxd62fl05d) ,■ /* 21 <• I 

GG (d, a, b, c, js[101, 522, 0x2441453); /* 22 */ 

GG <e, a, a, b, x[15I, S23, OxdBale681) ; /* 23 *7 

GG (b, c, d, a, * [ 4], S24, Dxe7d3fbc8 1 ; /* 24 '/ 

GG <a, b, c, d, x[ 9], 321, 0x21elcde6>; /* 25 */ 

GG (d, a, b, c, x[14), S22, 0xc33707d6>; /* 26 */ 

G<3 (e, d, a, b, x[ 3], S23, Oxf 4dS0d87» ; /* 27 V 

GG (b, c, d, a, x[ 8], S24, 0x455al4ed> ; /* 28 */ 

GG (a, b, c, d, x[13], 321, Qxa9e3e905» ,- /* 29 */ 

GG (d, a, b, c, x[ 2], S22, 0xfcefa3f8); /* 30 */ 

GG (c, c, a, b, x[ 7], S23, 0x676E02d9>; /* 31 */ 

GG (b, c, d, a, x[12], S24, Qx8d2a4c8a) ; }* 32 */ 

/* Round 3 */ 

HH (a, b, c, d, x[ 51, 331, 0xfffa3942); /* 33 */ 

HH (d r a, b, c, x[ 8], S32, 0x8771f681); /* 34 */ 

HH <c, d, a, b, x[U3, S33, 0x6d9d6122) ; /* 35 ■/ 

HH (b, c, d, a, x[14], S34, 0xfde5380c); /* 36 V 

HH (a, b, c, d, x[ 1], S31, 0xa4b»ea44) ; /* 37 */ 

HH (d, a, b, c, x[ 4], S32, 0x4bdec£a9) ; /* 38 */ 

HH (e, d, a, b, x[ 7], S33, Oxf 6bb4b60) ; /* 39 */ 

HH lb, c, d, a, x[10], S34, 0x£ebfbc7Q) ; /* 40 */ 

HH (a, b, c, d, x[13], S31, Ox289b7ec6) ; /* 41 */ 

HH (d, a, b, c, x( 0], S32, 0xeaal27fa) ; /* 42 */ 

HH (c, d, a, b, xt 3], 333, 0xd4ef3085) ; /* 43 */ 

HH (b, c, d, a, x[ 6], 334, 0x4881d05) ; /• 44 */ 

HH (a, b, e, d, x[ 9], S31, 0xd9d4d039> ; /* 45 */ 

HH (d, a, b, c, x{12], 532, 0xe€db99e5Jj /* 46 */ 

HH <c, d, a, b, x{15], S33, 0xlfa27cf8); /* 47 */ 

HH (b, c, d, a, x[ 2], S34, 0xc4ac5665); /* 48 */ 

/* Rour.d 4 */ 

II (a, b, c, d, x[ 0], S41, Oxf 4292244) ; /* 49 V 

II (d, a, b, c, x[ 7], S42, 0x432aff 97) ; /* 50 V 

II (c, d, a, b, x[14], S43, 0xab9423a7) ; /* 51 */ 

II (b, c, d, a, xl 5], 344, 0xfc93a039); /* 52 V 

II (a, b, c, d, x(12J, S41, 0xfi55b59c3); /* 53 V 
II (d, a, b, c, x[ 31, S42, 0x8f 0cco92) ; /* 54 */ 
II (c, d, a, b, x(10J, S43, Oxf fef f 47d) ; /* 55 */ 
II (b, c, d, a, x( 1), S44, 0xS5845ddl); /* 56 */ 
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II 


(a. 


b. 


c, 


d. 


x[ 8], 


S41, 


0x6fa8-?e4f ) ; 


/* 
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*/ 


II 


(et. 


a. 


b, 


c, 


x(15j , 


S42, 


Oatfe2ce6eO) ; 


/* 


5S 


*/ 


II 


<c. 


d. 


a. 


b, 


xf 6] , 


S43, 


0xa3014314) ; 


/* 
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II 


(b. 


Cr 


d, 


a, 


xtl3] , 


544, 


OxIeOSllal) ; 


/* 
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II 


(a, 


b. 




c. 


x( 4), 


S41, 


0xf753-?e821 ; 


/* 
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*/ 


II 


(d, 


a. 


b, 


c. 


x[ll], 


S42, 


0xbd3af23 5) ; 


(• 


€2 


-f 


II 


<c, 


d, 


a, 


bi 


x[ 2], 


S43, 


0x2ad7d2bb> 


/* 
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V 


II 


<b. 


c, 


d. 


s, 


x[ 9], 


S44 r 


0xeb86d391) ; 


/* 


64 


V 



statelO] +- a; 
stated] +- b; 
state [2] t- a 
state[3] += d; 

/* zeroize sensitive information. -/ 
memset I (POINTER) x, 0, siieof (x) ) ; 



* Encodes input (UINT4 ) into output {unsigned char). Assumes len is 

* a multiple of 4. 
V 

static void Encode (output, input, len) 

unsigned char "output; 

UTNT4 * input; 

unsigned int len; 

< 

unsigned int i; 



for <i - 0, j - 0; j < len; H-+ r j +- 4 ) ( 
output[j] = (unsigned char) (input [i] 4 Oxff); 
output [j+1] =» (unsigned char] < (input [i] » 8) i Oxff > ; 
outputij+2] = (unsigned char) ( (input [i] » 16) i Oxff); 
output[j+3] - (unsigned char) ( (input [i] » 24) & Oxff); 



* Decodes input (unsigned char) into output (UINT4) . Assumes len ia 

* a multiple of 4. 
*/ 

static void Decode (output, input, len) 
(JIHT4 *output; 
unsigned char "input; 
unsigned int len; 

{ 

unsigned int i, j; 

for (i = 0, j = 0; j < len; i++, j +- 1) 
outputli] - ( (UINT4) input [j] > I (( <OINT4> input [j « B> I 

(( (HINT4) input (j+21) « 16) I ( ( (UINT4) input ( j +3] > « 24); 

) 
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* Generate a random 32-bit quantity. 

f include <sys/time-h> /* gettimeof day ( ( */ 

^include <unistc.h> /* get..O */ 

^include <string.h> /* atrncpyO V 

♦include <stdLib.h> /* atoll) */ 

♦include <stdio.h> /* printfU V 
♦include <sys/ut3name.h> /* unamet) */ 

♦ include ctine-h> /* clock (> */ 
♦include "global. h" /* from RJC 1321 */ 
♦include "mdS.h" /* from RFC 1321 */ 

sxtern long gethost id (void) ; 

static char rcsid[J = "Sid: random32.c,v 1.2 1S98/Q9/29 16:31:-^ hgs Fxp S" 

♦define MD_CTX HD5_CTX 

»define HDInit MDSInit 

♦define MDUpdate MDSUpdate 

tdefine MDFinal MDSFinal 

typ«def unsigned long u_int32; 

static u_int32 md_32 (char 'string, int length) 

{ 

md_CTX context; 
union { 

char c[16]; 

u_int32 x[4]; 
} digest; 
u_int32 x; 
int i; 

MDInit (Scontext) ; 

MDUpdate (teontext, (unsigned char *)stringi length); 
MDFinal ( (unsigned char *)4digest, icontext); 
/* XOR the four parts into one word V 
for (i - 0, r = 0; i < 3; i++) r digest. x[i); 
return r; 
} /* md_32 */ 



/* 

* Return random unsigned 32-bit quantity. 
*/ 

uint32_t random32 (int type) 

{ 

struct { 

int type; 

struct timeval tv; 

elock_t cpu; 

pid_t pid; 

u_long hid; 

uid_t uid; 

gid_t gid; 

struct utaname name; 
\ a; 

g«ttiM«ofday(ia.tv, 0); 
a. type - type; 
s. cpu - clock () ; 
a. pid - getpidO ; 
s.hid - gethostidO ; 
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s.uid " geeuidO ; 
s.gid - getgidO ; 
uname I 4 3. name) ; 



return md_32((char *)& g , 3 i:eof(s>)r 
> /* candoir.32 */ 
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import java.io.'f 
import java.utJ.L-f ate; 

/** 

* An audio output stream is an output stream Cor writing data to a 
' (possible dummy) audio device. 

* <p> 

* The stream records performance statistics, such as the mi 1 1 iseconds of 

* "dead air", * the number of writes that were late, etc. Statistics are 

* Kept following the first write!) invocation. 

* <p> 

* For accuracy, the class Keep= statistics internally in microseconds, 

* but exports them in milliseconds. 

* <P> 

* On architectures supporting the " /dev/audio" device file (Solaria, Linux), 

* the AudioOutputStream will also write the data to the audio device. 

* Gauthor Alexander V. Konstantinou 

* Aversion SRevision: 1.5 S 

public class AudioOutputStream extends OutputStream { 
/** 

* microseconds per byte for 8 KHz, 8-bit MLAW samples 

public static final long mspb_9KH*_8bit_MLAH - 125; 

private long expiresMicros; 
private long microsPerByte; 
private long missedMicros; 
private long latewrites; 

private Fi leCutputStream fostream - null; 

1 * create new AudioOutputStream with default encoding 9 KHz, 8-bit MLAW 

* <p> 

* On architectures supporting a Vdev/ audio" device file, the constructor 

* will attempt to open the device for writing (but will not fail if 

* this is refused) . 
*/ 

public AudioOutputStream () { 
super l) ; 

microsPerByte = mspfc>_8KHz_8bit_JlLAW; 

// Try tD open the /dev/audio device file 
try { 

fostream =• new FileOutputStreamCVdev/audio") ; 
} catch (Exception e) { 

System.err.println{'!!!n!l Can't open /dev/ audio !!!!!!!!! 
fostream • null; 

\ 

) 

1 * Create new AudioOutputStream for an unknown encoding which 

* expands a byte of data to "microsecondsPerByte" <B>micro</B>seconds 

* <p> 

* Note that the value is in <B>microsecond3<B>, not milliseconds. 

» No'attenipt will be made to open the "/dev/audio" device file due 

* to the unknown format. 

public AudioOutputStream (long microsecondsPerByta) < 
super () ; 
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microsPerByte = raicrosecond3PerByte; 

f oat ream ^ null; // unltown encoding is not written to audio device 

> 

* Resets audio play statistics 
*/ 

public void reaetStats() { 
expiresMicros - 0; 
misaedMicroa = Of 
lateWrites " 0; 

} 

/** 

* Updates statistics for "count" bytes were buffered for audio output 
V 

private void logWriteBytes lint count) { 

long currentMicroa - System. currentTimeMilLis < ) * 1000? 
if [currentMicros > expiresMicros) { 
if (expiresMicros > 0) { 

missedMicros +- currentMicros - expiresMicroa ; 
<-+latswrites; 

} 

expiresMicros = currentMicros +■ count * microaPerByte; 
\ else ( 

expiresMicros +- count * microaPerByte; 

\ 

} 

/** 

* Writes the specified byte to the audio device. 

* Use of this method is discouraged, as the overhead for obtaining 

* the current time will be significant compared to the play time 

* for one byte- 
*/ 

public void write (int b> throws IOException ( 
logWriteBytes (1) ; 

if (fostream !- null] fostream . write <b) ; 

> 

/** 

* Writes b. length bytes from the specified byte array to the audio 

* device. 

* Avoid very small byte arrays for the same reason as write (int b) . 
V 

public void write (byte b|]» throws IOException { 
logWriteBytes (b. length) ; 
if (fostream I s null] fostream. write (b) ; 

) 

* Writes len bytes from the specified byte array starting at offset off 

* to the audio device. 

* Avoid very small lengths (lent for the same reason a3 write(int b) . 
V 

public void write (byte b[], int off, int Len) throws lOExeeption ( 
logWriteBytea (len) t 

if (fostream !- null) fostream. write <b) ; 

) 

/** 
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* Flushes this output scream and forces any buffeted output bytes to 

* be written out. Currently a no-op (does nothing). 

public void flush O throws lOException { 

> 

' ^ * Closes this output stream and releases any system resources associated 

* with this stream. 

public void close)) throws lOException { 
resetstatsd ; 
if (fostream != null) { 

fostreair. .close () ; 

fostrean. = null; 

} 

} 

^ * Returns the number of milliseconds of "dead air" up to the last 

* write. 

* Succesive invocations of this method without other intervening 

* AudioOutputStream method invocations will return the same value. 
*/ 

public long getMissedMillisAtLastWrite O ) 
return (missedMicras / 1000); 

} 

' 1 * Returns the number of milliseconds of "dead air" accumulated so far. 

* Succesive invocations af this method may not return the same value if 

* there is no buffered data for output, as this method returns the 

* total so far [current time) . 
•t 

public long getMiasedMillia < I { 

long currentMicros = System. currentTimeMillia ( ) * 1000; 

if (currentMicros > expiresMieros) { 

if (expiresMieros == 0) // special case - no writes so far 
return 0; 

Si return( (missedMicros t- [currentMicros - «npiroaMicroa> ) / 1000); 
\ else { 

return (missedMicros/1000) ; 

} 

} 

/** 

* Returns the number of late writes counted 30 far 
*/ 

public long getLateWriteCount () { 
return (lateWr ite a) f 

> 

' '* Returns the expiration time in milliseconds of the current audio 

* playing. 

* If no audio is currently buffered, will return the time 

* when the last byte completed playing. 

* Time is represented as microseconds between the current time and 

* midnight, January 1, 1970 UIC. This measure is system dependent, 
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* Flushes t.iis output scream and forces any buffered output bytes to 

* be written out. Currently a no-op (does nothing). 

public void flush O throws lOException { 

) 

/ * CLoses this output stream and releases any system resources associated 

* with this stream. 

public void close O throws lOException { 
resetstats < ) ; 
if (fostream != null) { 

fostreair. .close () ; 

fostreair. = null; 

} 

} 

1 ' * Returns the number of milliseconds of "dead air" up to the last 

* write. 

* Suceesive invocations of this method without other intervening 

* AudioOutputStream method invocations will return the same value. 
*/ 

public long g©tMi3sedMillisAtLastwrite < ) ( 
return (misaedMicros / 1000); 

> 

1 * Returns the number of milliseconds of "dead air" accumulated so far. 

* Succesive invocations of this method may not return the same value if 

* there is no buffered data for output, as this method returns the 

* total so far (current time> . 
*t 

public long getMiasedMillis < I { 

long currentMicros - Sy3teni.currentTimeMillis ( ) * 1000; 

if (currentMicros > expiresMicros) 1 

if (expireaMicros « 0) // special case - no writes so far 
return 0; 

el return( (missedtiicros + 1 currentMicros - «npireaMicroa> ) / 1000); 
} else { 

return (miaaedMicros/1000) ; 

> 

} 

1 * Returns the number of late writes counted so far 
*/ 

public long getLateWrit«Count 0 < 
return (lateWritea I f 

) 

1 ' * Returns the expiration time in milliseconds cf the current audio 

* playing. 

* If no audio is currently buffered, will return the time 

* when the last byte completed playing. 

* Time is represented aa microseconds between the current time and 

* midnight, January l, 1970 UIC. This measure is system dependent, 
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long aleepMillis - (long) (2 * U0s.9etBufferExpi.rat 
list)) * Math.candomO ) ; 

i£ (sLeepMLllis > 0) ( 

Sy3tera.out.println("Sle9ping " + sleepMaUis + " ..."); 

Thread. sleep (sleepMill 13) ; 

} 

> while (n != -1) ; 

aos.prlntStata {) j 
aos. close { ) ; 
} catch (Exception e) ( 
e . printStaekTrace ( ) ; 

> 

} 

} I! class AucioOutputStrecLm 
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import Java.awt.*? 
import java.io.'; 

public class TextEdit extends Frame ( 

public TextEdit (String [J commandArray, Marconi m) 1 
this.m = rn; 

this. commandArray - commandArray; 

setTitle ("TextEdit") ; 

Panel pi - new Panel (); 

pi . setLaycut (new FlowLayout ( ) ) ; 

pi .add (new Label ("filename: ")); 

filename - new TextField (commandArray [ 1 ] , 20); 

pi . add (filename ) ; 

add ("Center", pl>; 

Panel p2 = new Panel Of 

p2.setLayout (new FlowLayout <)) ; 

p2 .add (createButton = new Button ("Create")); 

p2.add (fir.isnEutton ■ new Button ("Finish")); 

add ("South", p2); 

} 



public boolean handleEvent (Event event) { 

if (event. id Event .ACT ION_EVENT Si event. target createButton) ( 
string fname = f ilename .getText ( ) ; 
if (fnarae .equals (""> ) return true; 
/* boolean flag - false; 

try ( 

BufferedReader br =■ new Buf feredReader (new FileReader ( fname) ) ; 

) 

catch (FileNotFoundExcepti.cn el { 
flag - true; 

) 

if (Iflag) \ 

System. out. println ("file "+fname+" already exists") ; 
return true; 
\ */ 

Frame re ■ new NewEdit ( fnarae, this) ; 
ne. resize (200, 150); 
this. hide <) ; 
ne , show ( ) ; 
return true; 

If (event. id — Event . ACTIOH_EVEtJT SS event. target =■» f jnishButton) { 
dispose () ; 

m.sendSchedule (commandArray, Thread. currentThread ( ) ) ; 
Thread. cur rentThreadO .suspend (); 
return true; 

i 

return super . handl«Ev*nt (event) ; 



/* 

public static void main (String [] args) { 
String [I 3tr - new String!]; 
Frame f - new TextEdit (str) ; 
f .setSiZ9(3C0, 150); 
f . show ( ) f 

} 

*/ 

private TextFi«ld filename; 

private Button createButton, f iniahButton; 

private string [] commandArray; 
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private Marconi m? 
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.mport java.io.*; 

.mport java.util.*; 

.mport java. lang. *; 

.mport java. text.*; 

mblic class Schedule extends Thread ( 

Jtivate String lmAddreas; 

private Marconi marconi; 

public static String scheduleFiLe; 

Public static int U dateAtcay = new int. [4]; 

sublic Schedule (String [] command, Marconi m) [ 
ImAddress - command [0] ; 
scheduleFile = command! 11; 
marconi = m; 

i 

public void run() { 
try 1 

byte[) requestPkt; 
boolean flag; 

while (true) { 

BufferedReader br =■ new Buf feredReader Inew FileReader (scheduleFile) ) ; 

int(] array - new int[B]; 
String str; 

while <(str - br , readLine O ) !- null) ( • 
int index - 0; *: 
StringTckenizer at - new StringTokeniswr (str, " ' 
for lint i=0; i<8; i++) { 
/* int endlndex - str .indexOf (' ', index); 
array [i] = Integer .parselnt (str. substring (index, endlndex) ) ; 
indeic - endlndex+1; */ 

array I i] - Integer .parselnt (at .next Texan O ) ; 

} 

// String fileName - atr. substring (index) ; 

String fileName - st . next Token () ; 
getCurrentOate () ; 

if ( isBetween ( array) ) { 
// start playing 

if (iaAddreaa<fileNam«) > flag - false; 
elsB flag - true; 

System. out. println ("fileName: «+f ileNarae) ; 

if requestPkt - marconi . encodeRequest ( (byte) 4, null, ImAddreas, fileName); 
else 

cequestPJtt - marconi. encodeRequest ( (bytell, fileName, ImAddress, null) ; 

marconi.sendRaqueat ( request Pkt ) ; 

/* Syaten. out .println ("now in date range:"); 

for (int i-0; i<6; i*+) { 

System.out.print(array[i] + " ") f 

> 

Sy st«m. out . println < ) ; 
if (flag) 

System. out .println ("Playing file "+fileName(; 
^System. out. printlnl'Redicecting packets from -+fileNarae) ; */ 
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while (true) < 

Thread, sleep <lQ0<h ; 

q etCurrentDateO ; 

if (! isBetween (array) ) break; 

} 

// atop playing 

requestPkt = maiconi , encodeRequest ( (byte) 2, null. ImAddresa, null); 
marconi. sendRequest (requestPkt) ; 
} if 

} 

) //while 

) 

catch lException e) { 
e. print St ackTr ace ( ) ; 

) 

) 

public boolean iaAddress (String str) ( 
int ccunt-0; 
int index=Ci,- 

while ( (index=3tr . indexOf (' , ' , index)) != -1) { 
count 
index-!--*-; 

1 

if (count == 3) return true; 
else return false; 



public static void mam (String args [ ) ) throws Exception I 
try { 

if (arga. length 1-1) { 

System. out . println ("Usage : Schedule < schedule data file>") ; 
return; 

> 

String acheduleFile - arga(0]; 
while (true) { 

Buf feredReader br - new BufferedReader (new FileReader (acheduleFile) > i 

int [J array - new int [8]; 
String str; 

while Hstr = br.readLine () ) !« null) ( 

int index - 0; 
for (int i=0; i<8; I 

int endlndex =■ str . indexQf (' ', index); 

arrayii] = Integer .parselnt (str. substring (index, endlndex)); 
index - endlndex+l; 

} 

String f ileNane - atr. substring (index) f 
String localNante - "LOCAL"; 
getCurrentDate < ) ; 

if (isB«tw««n (array) ) ( 

Sy3tem. out. println ("current time:"); 
foe (int i-0; i<4; { 

Sy stem. out. print (dateArr ay [i] + ■ "); 

} 

System. out .print In () ; 

System. out. println ("date range:"); 

foe (int i-0; KB; { 

System. out .print (array [i] + " "); 

\ 

System. out .printlnO ; 

5/stem.ouc .print In ("Playing file "+fileName( ; 
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while (true) { 

Thread. sleep(lOOO) ,- 

getC'4rrentDate<) ; 

if ( !isBetween (array] ) break; 

\ 

1! STOP PLAYING 
) // i£ 
> 

\ //while 

} 

catch (Exception e) { 
e .printStackTrace 0 ; 

> 

) // nain 



public static void getCurrentDateO { 
Date myDate ™ new Date O ; 

Calendar myCalendar =■ Calendar. getlnstance {) ; 
dateArray 10] *> myCalendar .get (Calendar .DAY_OF_WEEK) -1; 
dateArrayll] - myCalendar .get (Calendar. HOUR_OF_DAY) ; 
dateArray [2] = myCalendar .get (Calendar .MINUTE) ; 
dateArray [3] - myCalendar .get (Calendar . SECOND) ; 



public static boolean isBetween ( int [ ) array) { 

for (int i=array[Q|; ;i-(i+l)*7) { 
if (i — dateArray [0]) { 

if <i !- array[0] ££ i !- array [4] ) 
return true; //between 2 days 

if {i -- array [0]) ( //sometime on the left boundary day 
if (dateArray[l] <: array [1]) // if hour La earlier 
return false; 

if (dateArrayll] ™ array [1]) { // figure out the minutes 
if IdateArray [2] < array (2]> return false; 
if idateArray [2] — array[2]) ( // figure out the seconds 
if (dateArrayO! < acray[3]) return false; 
if (dateArrayll] — array[31 II arraylO] t-array[4|) 
return true; 

^ 

else if (dateArray [0] != array [4]) return true; 

else if (dateArray [01 1- array[4]> return true; 

if (i == array [4]) { //sometime on the right boundary day 
if (dateArrayll] > array[5]> // if time ia later 
return false; 

else if (dateArrayll] < array[5]> //has already been checked for early 

return true* 
else [ // hours are equal 

if (dateArray [21 < array [6]) return true; 

if (dateArray[2] > arEayt61) return £alae? 

//minutes are equal 

if (dateArray [3] > arrayP]) return false; 
return true; 

) 

^ 

break; 

] 

if (i — array [4]) break; 

} 

return false; 

} 
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} // class 
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mport java.awt."; 
mport java.io.*; 



public class WewEdit extends France ( 

public MewEdiC (String fileName, Frame f) < 
this.f = 

try { 

bw - new Buff eredWriter (new FileHriter (f ileName) I ; 

} 

catch ( lOEncept ion «l I 
System. exit (0) ; 

> 

this. filename = f ileName; 

setTit le ! "NewEdit" ) ; 

Panel pi = new Panel (); 

pi . setLayout {new FlowLayout () ) ; 

newButton = new Button ("New Entry") ; 

pi . add (newButton) ; 

f inishBut-on - new Button ("Finish") ; 
pi . add (f inishButton) ; 
add ("Center", pi); 

) 

public void proceasEdit (Edit Inf o info) ( 
String space = " 
try { 

bw. write (info. fromDay, 0, 1) ; 
bw. write (space, 0, 1) ; 

bw. writs (info.fromHour, 0, inf a - fromHour. length ()) ; 
bw. writs (space, 0, 1) f 

bw.write(info.fromMin, 0, info .fromMin. length () ) ; 
bw.write(space, 0, 1); 

bw. write (info. fromSec, 0, info .fromSec. length () I ; 

bw. write (space, 0, 1); 

bw. writs (info. toDay, 0, 1); 

bw. write (space, 0, 1) ; 

bw. writs! inf o.toHour, 0, info.toHour. lengthO ) ; 
bw. write! space, 0, 1); 

bw.write(infa.toMin, 0, inf o.toMin. length ()) ; 
bw. write (space, 0, 1); 

bw.writeUnfo.toSec, 0, info.toSec. length (}} ; 
bw. write (space, 0, 1); 

bw.writetinfo. filename, 0, info. filename. length () ) ; 
bw . newLine ( ) ; 

} 

catch (lOException e) ( 
System. exit (0) ; 

> 

public boolean handleEvent (Event event) I 

if (event. id Event. ACT I0N_EVENT 44 event. tar get »» newButton) { 
Bditlnfo in - new EditlnfoO; 
EditDialog ed - new EditDialog (this, in); 
ed . show < ) ; 

elae if (event. id — Event. ACT ION_EVEHT 44 event. target — f inishButton* ( 
try ( 

bw. close (> ; 

J 

catch (lOException e) { 
} 

dispose 0 ; 
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£.ahow() ; 

} 

return true; 

} 

private Button newButton, finishButton; 
private string fileName; 
private Buf f eredWriter bw; 
private Frame ff 



£lass Editlnfo < 

String fro^Day, toDay, fromHour, toHour, fromMin, toMin, fromSec, 
toSec, filename; 

Editlnfo (String frgmDay, String toDay, Strinq fromHour, String toHour, 
String fromMin, String toMin, String fromSec, String toSec, 
String filename) { 

thia.frorciDay - fromDay; 

this.toDay = toDay; 

thia.frorftHour = fromHour; 

this. toHour = toHouc; 

this.f ronjMin =■ fromMin; 

this.toMin = toMin; 

this. fromSec = fromSec; 

thia.toSec = toSec; 

this.f ilename = filename; 

} 

tditlnfot) () 



class Days ( 
List days; 
DaysO ( 

days ■ new List(l, false); 

days .addltemCO : Sun") ; 

days . addltem < " 1 : Mon") ; 

days . addlt etn < "2 1 Tue") ; 

days . addlt em < * 3 : Wed" ) ; 

days.addltemCS ; Thu") ; 

days . addlt em ( ■ 5 : Fri" ) ; 

days . addlt em <" 6 s Sat") ; 

days . select (0) ; 

} 



class EditDiaiog extends Dialog { 

public EditDialog (NewEdit parent, Editlnfo ul I 
super (parent, "Edit Entry", true) ; 
frontDay - new DaysO; 
toDay - new Days O f 
Panel pi - new Panel (]; 
pl.setLayout(new GridLayoutO, 2)); 
pi. add (new Label ("From day:"))f 
pi. add (fromDay .days) ; 
pi. add (new Label ("From hour:")); 
pi. add (fromHour - new TextField (2) ) ; 
pi. add (new Label ("From minute:")); 
pi. add (fromMin - new TextField (2) ) ; 
pi. add (new Label("From second:")); 
pi. add (fromSec - new TextField (2) ) ; 
pi. add (new Label < "To day :")),- 
pl.add(toDay.days) ; 
pi. add (new Label ("Td hour:")); 
pi. add (toHour - new TextField (2) ) ; 
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pi. add (new Label ( "To minute: "] I ; 
pl.add(toMin = new TextField !2)) ; 
pi. add (new Label ("To second:")); 
pl.addftoSec - new TextField ! 2 ) ) ; 
pl.add(new Label < "File/Channel : ■} ) ; 
pi. add (filename =• new TextField ( " " , 20)); 
CheckboxGroup g - new CheckboxGroup ( ) ; 
Panel p3 - new PanelO; 
p 3.setLaycut(new Flow Lay out I ! > ; 

P 3.add(local3ox = new Checkbox ("Local" , g, true)); 

P 3.add<globalBox =■ new Checkbox ( "Glofcal", g, false)); 

add ( "Center", p3) ; 

add("Nortr.", pi); 

Panel p2 = new Panel O; 

p2.ddd(okButton = new Button ( "Ok" )) ; 

p2.add (cancelButton - new Button ("Cancel") ) ; 

add ("South", p2); 

resize<2QC, 400); 

\ 

public boolean action (Event event, Object arg) ( 
if (arg, equals ("Ok") ) ( 

if (frcmHour. getText () .equals ("") II toHour . getText () .equals ( ) 
I! fromMin. getText () .equals ("") II toMin. getText < ) . equaLs < " " 1 II 
f romSec. getText 0 -equals ("") II toSec . getText [) .equals !" ") 
1 | filename. getText () .equals <"") ) 
return true; 
try ( 

if (integer. parselnt (fromHour. getText (I ) < 0 II 

Integer .parselnt (fromliour. getText (> ) > 23 I I 
Integer, parselnt (toHour. getTextO ) < 0 I I 
Integer .parselnt (toHour. getText () ) > 23 II 
Integer. parselnt (fromMin . getText () ) < 0 II 
Integer. parselnt (fromMin. getText 0 ) > 59 i I 
Integer. parselnt (toMin. getText O ) <0 II 
Integer. parselnt (toMin.getText () ) > 59 I I 
Integer. parselnt (fromSec .getText < ( ) < 0 II 
integer. parselnt (froraSec. getText {) > > 59 II 
Integer. parselnt (toSec. getText 0 ) <: 0 I I 
Integer. parselnt (toSec. getText () I > 59) 
return true; 

catch (NumberFormatException e) ( 
return true; 

\ 

String frame = new String!) ; 
String atr; 
boolean flag - false; 
if <globalBox.g«tState (I ) { 
try ( 

BufferedReader new BufferedReader (new FileReader <*_mapsta"> ) ; 
while ((atr - b.readlineO > !- null) ! 
int index * Of 

int endlndex - str.indexOf (' ', index); 

String addr - str.substring(index, endlndex) ; 

System. out. println("str: "+str. substring (endlndex+l) ) ; 

if ( (str. substring (endlndextl) ) .compareTo (filename. getTextO )— 0) ( 

ffiame - addr; 

flag - true; 

break; 

) 

) 

B. close () ; 

\ 
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catcll (lOExceptign e ) (> 
if (Iflag) < 

System. out. print In ("Channel name "+£ ilsname . getText ( ) + " not found": ; 
return true; 

else fname - filename. getText {) ; 
dispose O f 

Edltlnfo result = new Editlnfo (fromDay .days .getSelectedltem ( ) , toDay.days.getSelected 

*- tern () , 

frcmHour .getText O , toHour .getText () , fromMin , getText ( ) , 
toMin. getText O , fromSec . getText (} , toSec . getText () , fr.ame) ; 
( (NewEdit) getParent () ) .processEdit (result) ; 

f 

else if [arg. equals ("Cancel") ) { 
disposoO ; 

else return super .action (event, arg> ; 
return true; 

public boolean handleEvent (Event evt) ,[ 

if (evt.id =- Event .WIND0W_DE 3 TROY) disposed; 
else return super .handleEvent (evt) ; 
return true; 

} 

private TextField fromHour, toHour, fromMin, toMin, fromSec, to Sec, filename; , ; 

private Button okButton, cancelButton; 

private Days fromDay, toDay; 

private Checkbox localBox, globalBox; 
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3tribut(;d Ra dio Antenna Serv«r (HAS) : [IRC Action Handler] 



* 5<marconi.ir:.?IRCActionHandiec.java -v2 - 0 (prototype version), 1999/04/21 S 

* ejdkl.2, -riK- 
*/ 

package marconi.irc; 

import java.avt.*; 

import j ava. awt- event.*; 

import java.util. *; 

import java.io.*; 

/** 

* This class handles actions taken by IRC user. 
*/ 

public cla33 TRCActionHandler { 

public static Act ionLis tenet listCoritcol - new Act Loniistener ( ) { 
public void actionPerfotraedfActionEvent e) ( 
iRCControla .entry_l.setlext 

( IRCDireetory . directoryList_l .get I tern 
(IRCDirectocy.directoi:yList_l.qet3electedIndeK() ) ) ; 
String text field = iRCControls .entry_l.getText <] ; 
StringTokenizer dir - new StringTokeniter (textf leld, " "); 
int id - Integer.paraernt(dir.nextTokenO) ; 
if (iRCDirectory. owner. playChannel (id) > { 

System. out . print In ("marconi . ice. IRCActionHandler' + 

* .act ionPer formed: playing channel ■ 
+ id ■(•".") ; 

} 

else ( 

IRCDireotory . owner. stopChannel () ; 

System. err . print In ("mar coni . ire . TRCActionHandler " + 

" .actionPerformed: error listening.". ; 

\ 
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/* marconitfet - rnternet Radio Network 

* Distributed Radio Antenna Server (RAS) : [IRC GUI Controls) 

* 5<fnarconi-irc.>IRCConteola. java -v2 . 0 (prototype version), 1999/02/15 S 

* Ujdkl.2, -riK- 
*/ 

package marconi.irc; 

import java.awt.*; 

impart java. awt .event . * ; 

import java.uti-L. *f 

import java. net.*; 

import java.io-*; 

* This panel contains user interfaces to the applet. 

public class IRCControls extends Panel ( 
public static TextField entry_l; 
private static int WIDTH = 600; 
private static int HEIGHT = 100; 

/** 

* Instantiates the control panel. 
*/ 

public IBCControls ( \ 1 

GridBaglayout grid - new GridBag Layout () ; 
GridBagConstraints cons - new GridBagConstraint3 0 ; 
setlayout (grid) ? 

cons. rill - GridBagConetraint3.NONE; 
cons.weightx =■ 0.0; 

// selected station (id f name) 

entry_l = new TextField [ 40) ; 

grid.setConstraints (entry_l, cons) ; 

entry_l , setForeground (Color .yellow. darker () ) ; 

entry_l.eetBacJcground (Color . blue. darker () .darkerO); 

add(entry_l) f 

validate () ; 

// reaise 

setSize(WIDTH, HEIGHT); 

) 

) 
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* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : I IRC Directory Controlsl 

* S<marconi . ras , >IRCDirectory. ]ava -v2 . 0 (prototype version), 1999/04/20 5 

* Sjdkl.2, -riK. 
*/ 

>ackaga marconi . ire; 



.mport java.awt.*; 

.mport javs .aut .event . *; 

.mport java.utiL.Hashtable; 

.mport java.net.*; 

.mport ]ava. io , k ; 

.mport marconi . ras . MarconiServe 

.mport marconi . util -CDPPacket; 



* This panel contains user interfaces to the applet. 

public class IRCDirectory extends Panel 
implements Runnable 1 

/ * This thread updates the announcements for the locally supported channels. 
*/ 

private Thread updateThread =■ null; 
private static Long L_UPDATE - 7500; 

public static iRCUsrApplet owner; 
public static Label label_l; 
public static List directorylist_l; 
private static int WIDTH - 600; 
private static int HEIGHT - 400; 



* Instantiates the directory display panel. 

public IRCDirectory (IRCUsrApplet main) ( 
owner = main; 

GridBag Layout grid =■ new GridBagLayout O ; 
GridBagConstraintS cona - new GridBagConstraintS <) ; 
setLayout (grid) ; 

cons. fill - GridBagConstraintS. ncne; 
cons.weightx - 1.0; 



// label 1 
cons.weightx - 1.0; 

cons.gridwidth - GridBagConstraintS .REMAINDER; 
label_l - now Label <>; 

label_l.setlext ("Local Channel Directory*); 
grid.setConstraints(label_l, cons); 
label_l - setForeground (Color . white ) ; 
add(label_D ; 
validate 0 ; 

// list 1 - global 

cons.gridwidth - GridBagConstraintS .REMAINDER; 
directorylist_l - new List (20, false); 

direct oryList_l . addActionListener ( iRCActionHandlec . list Control) ; 
grid . s etc on st r a int s (direct oryList_l , cons 1 ; 
directoryLiat_l . setForeground (Color . yellow.br ighter O ) ; 
direetoryLiat_l . setBaclcground (Color . darkGray ) ; 
add(directoryLiat_l) ; 
validate ( ) ; 
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// resize 

setSize<WIDTH, HEIGHT) J 

start < ) ; 

I 

/** 

* Starts the directory update. 
*/ 

public void start () ( 

updateThread = new Thread (this ) ; 
updatelhread. start () ; 

) 

/** 

* The run methods for the two threads. 
*/ 

public void run() { 

If local directory 

while (Thread. current Thread () == updatelhread) ( 
try [ 

Thread. sleep (L_UPDATE) ; 

Hashtable cdp_loo)cup » owner .getCacheO ; 

if (directcryLiat_l .getltemCount ( ) > 0) { 
directcryl,iat_l . removeAll I ) ; 

) 

for (int ± - 0; i < owner . MAX_CHANNELS; t *' 

String Id - St ring . va L ueOf (i ) ; : '■ 

if [cdp_lookup.contain3Key (Id) ) { 

CDPPaclcet cdp » (CDPPacket) cdp_lookup.get (Id) ; 
directoryList_l.add<cdp.id + " " +■ cdp. name, 

Integer .parselnt (cdp. id) ) ; 

> 

else ( 

directaryList_l . add ( Id) ; 

> 

} 

if (cdp_lookup.contoinsKey (MarconiServer.LCCALSTA) ) ( 

CDPPacket cdp - (CDPPacket) cdp_lookup.get (MarconiServer . LOCALSTA} ; 
directory List_l . add (cdp . name ) ; 

} 

f 

catch (Exception e) { 

System, err . println < "marconi . ire . IRCDirectcry . run : ■ ) ; 
s.printStackTrace () ; 

) 



WO 00/79734 



PCT/LS00/I6913 



IBCTr«rApplet . 




7 14:22:23 1999 



1 



/* marconiNec - Internet Radio Network 

* Distributee Radio Antenna Server {RAS> : (IRC User Applet] 

* $<mareoni-.irc.>IRCUsrAppiet . java -v2 . G (prototype version), 1999/0-1/20 5 

* Sjdkl.2, -tiK. 

package marcor.i . ire; 

import java. applet. *; 

import java.awt-*; 

import java . ut 11 . * ; 

import java. ret-*; 

//import java, rmi . * ,- 

//import java . rmi, 3erver. *; 

import marcor.i . util . *; 

import marcor.i . util. rtsp- IRC; 

import marcor.i . ca s , RAS; 

import marcor.i. ras.MarconiServer; 

/** 

* This applet is used by an IRC user. 

* (tauthor -riK. 

* Aversion SRevision: 1.0 S 

* (Jaee marconi . raa .MarconiServer 

* (Ssinca prototype vl.O 
*/ 

public class iRCUsrApplet extends Applet 

implements java . io . Serialisable, Runnable ( 

/** 

* Session Announcement Protocol (SAP) resources. 

* Interfaced via. Channel Cirectory/Description Protocol (CDP) . 
V 

private MulticastSocket cap_receiver - null; 
protected tJashtable capCache - null; 

* This thread updates the announcements for the locally supported channels. 



private Thread direct oryThread - null; 
private static long L_UPDATE - 10000; 

// miscellar.eioua variables 
private static int widfch " 0; 
private static int height - 0? 
//protected RAS rasServer - null; 
protected int HAX_CHAWJELS - 20; 

final static String objjiame - "marconi ■ ras . IRCUsrApplet"; 
// tools 

iRCDirec-ory directory - nullf 
IRCControls controls « null; 
IRC listener - null; 

/** 

* initialize the applet and setup display area. 
*/ 

public void initO < 



try { 



width - Integer .par selnt {getParameter ( "APPItWIDTH* ) ) J 
height - Integer. parselnt (getParameter ( "APPLHEIGHT") ) ; 



// lookup RAS (MarconiServer) 
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//URl URl^K e = getOocumentBaaeO ; 

/ /System. out . print In (obj_name + ".init; locating aervtt') ; 
//rasServec » (RAS) Naming . lookup (*// * + getFarameter ( "RASKoat" ) 
// ■(-":" + getParameter < "RASFort") 

// +• Vmarconi.ras.MarconiServer") ; 



// init variables 

//MAX_CHANNELS = raaServer . getMaxChannels ( ) ; 
capCache - new Hashtable () ; 

) 

catch (Exception e) ( 
// fatal error 

System, ere. prir.t In (ob j_na«ie + ".init; "); 
e.printStackTraceO ; 



U join CAP multicast group 
try ( 

cap_reeeiver = new Multicastsocket (Marconiserver .CAP_PORT) ; 
cap_receiver . joinGroup I InetAddress . getByHame (Marconiserver. LOCAL_CAP I ) ; 

) 

catch (Exception e) { 

System, out . prir.t In {obj_name t ".init;"); 
e.printStackTrace () ; 



// draw display area 
setupDisplay () ; 



// start 

Listener = new irc I ) ; 
directoryThread = new Thread(thi3) ; 
directoryThread. start () ; 



/** 

* Display the applet. 
*t 

public void setupDisplay () { 

3etBackground(CoLor. black) ; 

directory = new rRCDirectory (this) ; 
controls - new rRCControls ( ) ; 
GridBagLayout grid - new GridBagLayout () ; 
GridBagConatraints cons - new GridBagConacraints O ; 

// setup grid 

int rovHeightaM - (400, 100>; 
grid.rowHeights * rowHeighto; 
aetLayout (grid) ; 

cons. fill - GridBagConrjtraints.BOTH; 
// add directory liata 

ccns.gridwiclth « GridaagConstraints . [REMAINDER; 
cona.weigtitx - 1.0; 
cons.gr idheight - 1; 

grid. aetConstraints (directory, cons) ; 
add (directory) ; 
validate () ; 

// add controls 

cona.gridwidth - GridBagConatraints. REMAINDER; 
cons.weightJt — 1.0; 
cons.gridheight - 1; 
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grid. setconstraincg (controls, cons) ; 
add (controls > ; 
validate () ; 

resize(width, height); 

* Free resources when closing applet. 
•/ 

public void destroy 0 ( 

// release sockets and leave announcement group 

trY cap_receiver.leaveGroup(TnetAddreS3-get3yNamelMarcona3erver.L0CAL_CAP) ) ; 
cap_recei ver . close ( ) ; 

) 

catch (Exception e) \ 

e . pr intScacHTrace < ) ; 

) 

stopChannel < ) ; 
directaryThread = null; 

//try { 

// rasServer .terminate <) ; 
//> 

//catch (SeinoteException e) ( 
// e.printstacXTrace ( ) ; 

//} 



remove (directory) ; 
remove (controls) ; 



* Run method. 
V 

public void runO { 

II cache update hour 

long hour = System. currentTimeMillis () ; 
/* 

* Global directory thread running. 

while (Thread. currentThreadO — directory Thread) { 

* Receive CDP packets and maintain channel database. 
*/ 

try < 

DatagramPacket recv_pkt - CDPFacket. compose ( ) ; 
cap_j:eceiv«c. receive (recv_pkt) ; 

CDPPaenet cdp - new CDPFacket<recv_pkt) ; 

System, out. prifttln<objjian» t ".run: cdp parsed") ; 

// update announcement appropriately 
if ( icapCache.containsKey (cdp. id) ) { 
capCache.put (cdp. id, cdp); 

System. out. println (obj_jiame + ".run: new cdp cached for channel- 
+ cdp. id) ; 

) 

\ 

catch (Exception e) \ 
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e . printStackTrace ( ) ; 

!/ time to refresh cache (daily) 

Long current_hcur - System . cur rentTimeMi 1 Lis O f 

if <current_hour > hour + Time stamp. DAI) { 

System. out. println (obj_name 1- ".run: routine -refreshing directory cache. 

ref resh_cache ( ) ; 

hour t- Time stamp . DAY; 

} 

/* 

* Interval b/w each loop for receiving local channel director/. 
*/ 

try I 

Thread . sleep <L_UPDATE ) ; 

) 

catch (incerruptedException e) [ 
> 

> 

/*" 

* Removes old cache entries. 
V 

protected void ref resh_cache O { 

long current_hour = System. curxentTimeMil lis 0 ; 

synchronized (capCache) I , ' 

Enumeration capList - capCache . elemer.ts () ; , i 

while (capList.hasMareElementsO) ( 

CDPPacket cdp = (CDPPacket) capList .nextElement O ; 
if (currentjiaur > cdp. tineStamp + CDPPacket .TTL> { 
capCache. remove (cdp. id) ; 

> 

} 

} 

} 

inform server that the specif Led channel is being listen to. This 

* RMI based triggering is very inefficient and not scalable. So 

* alternate approach based on RTCP should replace this. 
*/ 

public boolean playChannel (int id) ( 
boolean status - false; 

if ( capCache. containsKey (String. valueOt I id) )> \ 

CDPPacket Cdp - (CDPPacket) capCache. get (String. valueOf [id) ) ; 
try I 

// kill previous thread if running 

listener .stop O; 

/* 

* The below statement is commented out because the listener 

* is now capable of sending RTCP signals for triggering. 

status - rasServer.playChannel (id) ; 
•/ 

status - true; // replace above 
listener. start (cdp.MADDR, cdp.KFQRT) ; 

) 

catch (Exception e) \ 
e .print St ackTrace ( ) ; 
return false; 
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return status; 

> 

else { 

return false? 

) 



* Stops listening to whatever is playing. 
•/ 

public void stopChannel () < 
listener. stopt) ; 

> 

* Returns the current state of the local channel announcement cache. 
*/ 

protected synchronized Hashtadle getcachel) f 
retucn capCache; 

1 

/** 

* Return applet information. 
*/ 

public String getAppletlnf o ( ) { 
return "IRC listener tool" J 

) 



} 
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'* mar;o/iiNat - internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [AD GUI Controls] 

* S<inan:oni . cas . >MCont rola . ]ava -v2 . 0 (prototype version), 1999/05/16 S 



*/ 

jackage marconi . ras; 



.mport java.awt . *; 

Import java.awt .event. 

Import java.Lo.*; 

Lmport marconi .util .Vector2; 



* This panel contains user interfaces for the ad insertion. 
*/ 

sublic clas3 ADControls extends Panel ( 
public static RASMgrApplet oarer; 
public static Choice ida; 
public static TextFieid entry_l? 

public static Button button_2, button_3, button_4; 

public static List directoryLiat_l ; 

private static int WIDTH = 600; 

private static int HEIGHT «• 2C0; 

private static Vector2 ad3 - r.ew Vector2(); 

/" 

* Instantiates the control panel. 
*/ 

public ADControls (RASMgrApplet main) ( 
owner - main; 

GridBagLayout grid ™ new GridBagLayout O ; 
GridBagConstraints cona = new GridBagConstraints 0 ; 
setLayout (grid) ; 

eons. fill = GridBagConstraints. BOTH; 
cons.weightx = 0.0; 

// channel id 

ids => new Choice Of 

update I Da O ; 

grid.setConstraintsUds, cona); 
ids. setForegraund (Color. black) ; 

// ids .setroreground (Color. yellow. darker ( ) ) ; 

id3 . setBackground (Color . lightGray I ; 

// ids. setBackground (Color. black) ; 

add (ids); 

validate!); 

// commercial filft input 
entry_L - raw TextField<20) ; 
grid. setConstrainta <entry_l, cons) ; 
entry_l .aetForeground (Color .black) ; 

// entry_l. aetForeground (Color . yellow. darkerO ) ; 

entry_l. setBackground (Color. gray. brighter (} ) ; 

// entry_l. setBackground (Color . blue. darker 0 .darker)] ); 

add(entry_l) ; 

validated; 

// add commercial 

cona.gridwidth - GridBagConstraints . REMAINDER; 

button_2 = new Button (" Add Commercial *>; 

button_2 . setActionCommandCAdd Commercial") ; 

button_2 . addActionListwier (FASAetionHandLer . buttonControl) i 
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button_2 . setBackground (Color. ligtltGray) ; 

// button_2. setBackground (Color .black) ; 

button_2 . setForegrcund (Color, black) ; 

// button_2 .setForegcound (Color . red) ; 

grid.setConatrainta (button_2, cons) ; 

3 dd(button_2l ; 

validate Of 

// List 

// cons.weightx - 1>0; 

cons.gridwidth - GridBagConstraints . REMAINDER; 
directoryLiat_l - new List I 5, false); 
gr id. setConstraints (directoryLi3t_l , cons) ; 
directoryList_l . setForeground (Color .black.) ; 

// directorvList_l .setForegrcund (Color .yellow .brighter ( ) ) ; 

directoryList_l . setBackground (Colot . white) ; 

// directoryli.st_l. setBackground (Color. darieGray) ; 

add(directoryLiat_l] ; 

validate (); 

// submit commercial list 

cona .gridwidth = GridBagConatraints . RELATIVE; 

button_3 = new Button!" Submit List ">; 

but t on_3. setActionComraandC Submit Commercials"); 

button_3. addActionLi3tener {RASActionHandler .buttonControl) ; 

button_3 . setBackground (Color . lightGray ) ; 

// button_3 .setBackground (Co lor .black) ; 

button^ 3 . setForeground (Color .black) ; 

// button_3 . setForeground (Color . red) ; *' 

grid.fletConstraint3(button_3, cons); •' 
add(button_3) ; 
validate Of 

// remove commercial 

cons .gridwidth ■ GridBagConstraints. REMAINDER; 

button_4 =■ new Button (" Remove All *) ; 

button_4 .setActicnCocranand<"Remove Commercials") ; 

button_4 .addActicnListener (RASActionHandler .buttonControl) ; 

button_4 . setBackground (Color . light Gray ) ; 

/ / hutton_4 . setBackground (CoLor .black) ; 

button_4 . setForeground (Color .black) ; 

! ( button_4 . setForeground (Color , red) ; 

grid.3etConatraitita<huttoiL4 J cons); 

add(button_4) ; 

validate O; 

// resize 

3etSiie(llIDTH, HEIGHT) f 

} 

{*■* 

* Add additional entry. 
*7 

protected static void procesoAddO { 

if (entry_l.getText<) . length () > 0) { 
try < 

String entry - Integer .parselnt (ids. getSelectedlteraO > + ■ ■ + entry_l .get. 

<■ t in- 
direct oryList_l. add (entry) ; 
ads. addGlenent (entry) ; 

) 

catch (NumberFomatBxception e) { 

owner. showrtessage ("Please select a channel!", true); 

> 
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> 

// clear input fields 
entry_l . setText (""),• 

> 

/** 

* Remove all entries. 

*/ 

protected static void proceasRemove < ] { 
if (ads. size 0 > 01 [ 

directoryList_l . removeAll ( ) ; 
ad3 . removeAllElements ( I ; 

) 

} 

I*" 

* Submit the commercial list to the server. 
V 

protected static void process Submit ( t { 
try ■: 

if (ads. size O > Q 5* owner, rasServer . submitCommercialList (ads.toStringArray 0 ) ) 

owner .showMea sage ("Commercial list submitted..-", false); 
processRemove () ; 
entry_l . setText I ; 

else { 

owner. ahowMessage( "Commercial list could not be submitted!", true); , , 

> ! ; 

\ 

catch (Exception e> ( 

owner. showMe3sage ("Coawiercial list could not be submitted!", true) ; 

} 

) 

/" 

* Updates available channel ids. 
V 

protected static void update I Ds { ) ( 
ids . removeAll ( I ; 

far (int i = Of i < owner. channellDs . length; i-n-) ( 
if < owner. channellDs [ i] ) { 

ids. add < String. valueOf (i) ) ; 

} 

) 

if Uds.getltemCountO — 0> < 
id3.add<"EMFTX"); 

\ 
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/* marconiNet - Internet Radio network 

* Distributed Radio Antenna Server (RAS) : [Channel Class] 

* $<™arconi.raS.>Channel. java -v2 . 0 (prototype version), 1995/01/06 5 

* ajdkl.2, -riK- 
*/ 

package marconi. ras; 

import java.io.*; 
import javA.nfit.*; 
import java.utii . 
import java.rmi.*; 
import marconi..util . *; 
import marconi .util . rtsp. *; 
import marconi. . rac.RSC; 
impart java . security . Security; 
impart javax , crypto .* ; 
impart javax . crypto, spec. * ; 

import au .net. aba. crypto. provider. ABAProvider; 

1 ' * The <code>Channel<:/code> class creates two threads in which it can start 

* the necceasary operations for maintaining the channel. First, it creates 

* a thread that listens and monitors the RTCP signals from IRCs. when this 

* thread detects that there is at least one IRC that wants to listen to thi3 

* channel, it creates the second thread which begins performing the redirection 

* process (receive concent frara global addreaa, decrypt, write content to 

* local address) . The <i>rtcp thr*ad</i> continues the monitoring so that 

* if it detects that no one is listening to the channel anymore it terminates 
- the <i>redirection thread</i>. This helps reduce the bandwidth being wasted. 

* Additionally, <code>Channel</code> will store the details of its content 

* provider (radio station) and -he broadcast/multicast medium. 

* <p> 

* Sauthor ~riK. 

* Qversion $Revision: 1.0 S 

* Qsee marconi. ras. Marconi server 

* Ssee marconi. ras. StationProfile 

* @since ' prototype vl.O 

public class Channel implements Runnable ( 

final static String obj_name - "marconi. ras. Channel*; 



* The assigned channel number, 
protected int chanID; 

/** 

* The radio station. 
*/ 

private BSC station - null; 
/** 

* The radio station's hostname. 
V 

private String host - null; 
/** 

* The radio station name. 
*/ 

public String name - null; 
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* The main category of this channel's content [ music 1 news I sport s I . . . \. 
V 

public String category - null; 
/** 

* The content description. 

V 

public String description = null; 
/** 

* The origin of the content. 
V 

public String origin = null; 
/** 

* The language used in the content, 
V 

public String language - null; 
/** 

* The radio station's url (not in use by the current protocol). 
'/ 

public URL url - null; 
/" 

* The station's glocaL multicast address, 
V 

protected rnetAddresa g_maddr; 

/" , ! 

* The station's local multicast address. 
*/ 

protected rnetAddreas l_maddr; 
/* 

* The encryption resources. These private declaration allows for Later 

* extension where the hard-coded values such as the SEK algorithm and key 

* length can be obtained from announcement. In such cases various encryption 

* methods can be supported and allows the encrypting party (content sender) to 

* decide an which algorithm to use. 
*! 

private byte [I SEK = null; // session encryption key 

int sek_id — -If // RSC registration id 

byte[] publicKey - null; // RSA public key 

byt*[] privateKey - null; // RSA private key 

private final static String SECRET^MG = "RC4"; // encryption algorithm 
private final static int SEK1EN » 8; // encryption key length 

/" 

» Channel database initialized (install JCS and thread counter) . 
V 

private static boolean DB_INIIIALIZED - false; 
I" 

* Daily program schdule. 
*/ 

private Hashtable programSchedule - null; 
/** 

* Daily commercial schedule. 
*/ 

private Hashtable commercialSchedule - null; 
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* The radio antenna server can activate the channel broadcast ing by 

* starting this <code>channellhread</code>. 

private Thread channelThread - null; 

1 * The channel broadcasting does not actually begin unless this RTCP listener 

* thread dejecta that there is at least one listener preser.t at the time. 
V 

private Thread rtcpThread = null; 
/** 

* This variable indicates the state of the thread (active or suspended) . 
"/ 

private boolean threads uspended = false; 
/** 

* Manages the number of running thrsads (channels) - 
*/ 

protected a'-atic ThreadCountManager thrcadCounter - null; 
/** 

* The RTCP listener. 
*/ 

private RTCPListener rtepListener - null; 
private RTCPSocket rtepRegistry =■ null; 

/* 

* Multicast resources- ,t 

*/ , : 

byte recv_buf [J; // receiver buffer 

byte sencLbuf (]; // receiver buffer 

DatagramPacket recv_pack; // receiver packet 

DatagramPacket send_pack; // receiver packet 

private MulticastSocket recv_msockf // multicast socket for receiving 

private MulticastSocket sendjisock; // multicast socket for sending 

private boolean S0CKET_IN_USE - false; // prevents abrupt socket kill 

/" 

* Creates a new thread and starts the <eode5>Channel</eode> operation 

* which consists of broadcasting (multicasting) the channel contents 

* to its local clients and storing the station profile. 

* aparam chan_id the channel number. 

* eparara raaddr the local multicast address. 
V 

public Channel <int chan_id, inetAddress maddr) { 

// install jce provider 
if ( J DB_INITIALIZED) { 

threadCounter * new ThreadCountManager () ; 

DB.IHIXIALIZED - Security . addProvider (new ABAProvideirO ) > -1; 

} 

// initialize channel 
chan ID - chan_id; 

prcgraraSchedule =* new Hashtable (); 
connnercialSchedula - new Hashtable 0 ; 
g_jnaddr « null; 
l_niaddr - maddr; 

// initialize rtcp listener 

rtepRegistry - new KTCSSoeket (Maddr Dispenser, rtcpjiap (maddr) , 
MarconiServsr . irc_PORT+ 1 , true ) ; 
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rtcpLiatener - new RTCFListener ( rtcpRegistry, . 
rtcpListener. start : I ; 
rtcpThread <= new Thread ( this ) ; 
rtcpThread . start ( ) ; 

> 

/** 

* ll-.is <code>run</code> method implements the channel' s broadcast 

1 cperation. 

V 

public void runl) { 

/* 

* Channel thread running. 
*( 

while (Thread. curr*ntThread<) -= channellhread) ( 

// receive audio packet 
SOCKET_IN_USE = true; 
try { 

/ / init receiving packet 

recv_buf - new byte | Marconi Server . KAX__ PAYLOADLEN 

t MarconiServer ,MAX_RTPHDRLEN] ; 
recv_paek - new DatagramPacket ( reev_buf , recv_buf . length) ; 
recv_msock. receive <recv„pae)0 ; 

//System. ojt.printlni "received RTP from " + recv_pack . getAddress <) + ";" - i 
*- cv_pack.getPort O > ; 

\ •* 
catch (Exception e) { , • 

System. out. println<obj_name + ".run: channel-" +■ chanID) ; 
e .printStackTrace O ; 

I 

SOCKET_INJJSE - false; 

II Decrypt & send local 
int n - recv_pacfc.getLength<) ; 
if (n > 0 «« 3EK !- null) < 
try I 

//Cipher cipher - Cipher. getlnstance <SECRET_ J ALG) ; 

//cipher. init (Cipher. DECRYPT_MODE, new SecretKeySpec ( SEK, SECRET_ J ALG] ) ; 

//byte[] send_buf - cipher .doFinal ( recv_paclc.getData {)) ; 

byte[] send_t>uf - recv_pack.getData ( ) t 

aend_paek - new DatagramPacket (send_buf, n, l_maddr, 

MarconiServer . IRC_P0RT) ; 
send_nsock.send(send„pack, (byte) MarconiServer . LOCALJITL) ; 
//Systen.out.println("sent to " + sendLpack.getAddress ( ) ■!-":"+ aefid_p< 



¥ k . getPort < ) ) ; 



> 



) 

catch (Exception ej { 

System ■ out. println (obj_name +■ ".run: 
e . printStackTrace ( ) ; 

} 



/* Uncoomiaiit he low to uee variable sleep feature, (and comment above) . 

* Sleep, (accordingly wet * of running channels) 

*./ 

try { 

Thread . sleep (threadCounter .getSleepIiae ( } ) ; 

synchronized (this) ( 

while (threadSuspended 41 channelThread !- null ) ( 
waitO; 
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i 

} 

i 

catch (interruptedExEeption e) ( 
} 

/"/ 

// Let other channels (threads) run (time-slicing) 
/ /Thread. yield O ; 

\ 

/* 

* RTCP listener thread running. 
*/ 

while (Thread. current Thread < ) ~ rtepThread) < 

//System, out. println(obj_nartie + ".run: channel-" + charilD + " nam ircs=" + rtcpRe 
gistry . getNumMembers O ) ; 

// determine whether or not ta start the channel thread 
if (liaOnlineO 44 rtcpRegistry .getNuroMembers 0 > 0) i 
try ( 

start ( ) ; 

System. out . println (obj_name + ".run: channel-" +■ chanID 
+ " started"); 

) 

catch (Exception e) { 

System. err .println <obj_name + 

".run: cannot start channel-" + chanlD); 

) 

} 

// determine whether or not to stop the channel thread 
iC (isOnlineO SS rtcpRegistry . getNuraMembers 0 — 0) { 
stopO ; 

System. out. print In <obj_name + ".run: channel-" + chanID 
+ " stopped") ; 

i 

/* Uncomment below to use variable sleep feature, (and comment above) . 

* Sleep, (accordingly wrt I of running channels) 

*/ 

try { 

Thread. sleep (threadCounter .getSleepTime () ) ; 

synchronized (this) ( 

while (threadSuspended ii channelThread !- null ) { 
waitO; 

) 

) 

i 

catch (intecruptedException e) ( 

} 

/"/ 

// let other channels (threads) run (time-slicing) 
//Thread. yield () t 

} 



* Starts the broadcast thread for this channel. The channel will begin 

* to listen on its content provider's data stream and do its protocol 

* process (strip-off header, chec* for special packet, decrypt, etc.) 

* and broadcast (multicast) the remaining audio data to all clients tuned 

* to this channel. 

* (^exception TooManyChannelThreadoException if too many 
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* <code>channelThread</cQde>3 are cunning (broadcasting) . 

*/ 

public synchronized void start () throws TooManyChanneiThreadsException { 

if ( lisOnline <) ) | 

if (g_jnaddr !- null SS threadCounter . addThread ( ) ) { 
System. out . println ( ob j_name 

+ ".start: initializing channel-" 
+ chanlD) ; 

// create sockets 4 join group 
try i 

send_nisock « new MulticastSocket () ; 

recv_msock = new HulticastSocleet (MarccniServar.RSC_POST) ; 
cecvjisock. joi.nGroup (gjnaddr I ; 

► 

catch (lOException e} ( 

System. err. println (Ob j_na*ne +■ ". start:")! 
e . printStackTrace < ) ; 

\ 



// start channel announcement thread 
channelThrsad » new Thread (this ) ; 
channelThread . 3tart ( ) j 

) 

else { 

throw new TooManyChannelThraadsException 

(obj_name + •.start: too many threads running"); 

1 

} 

else { 

throw new UlegalThreadStateExcaption 
(ob j_name 

+ ".start: broadcast thread already running for channel-" 
+ chanID) ; 

} 

) 

/** 

* StopB the broadcast thread for the channel . The channel itself is not 

* to be destroyed. 
"/ 

public synchronized void stopO { 

it (isonline<)> { 

if (threadCounter. removeThreadU I ( 

lj free sockets £ threads 
try \ 

channelThread - null; 
whil« (SOCKET_IN_USE) ( 
Thread. sleep <3); 

} 

recv_jn90Cli.leaveGroup(g_jnaddr) ; 
recvjnsock. close () 
aend_jnsock. closed ; 

) 

catch (Exception a) { 

System, err. println (obj_name +■ ".atop;")i 
e .printStackTrace ( ) ; 

\ 

finally ( 

notify (] t 

\ 
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) 

else < 

//do nothing 

) 

else •; 

throw new IlLegalThreadStateException 
|obj_name 

+ ".atop; broadcast thread not running for channel-" 
+ chanID) ; 

> 

> 

/** 

* Step all threads and destroy this object. 
*/ 

public synchronized void destroy O ( 
atop I > f 

rtcpThread - null; 
rtcpListener.stopO ; 
rtcpRsgistry .clsse () ; 

) 

* Temporarily suspends the running broadcast thread, 
public synchronized void suspend (> ( 

if UsOnLineO) i 

threadSuspended - true; f ; 

notityO; 

else { 

throw new lllegaLThreadStateException 
(obj_name 

+ ".suspend: broadcast thread not running for channel.-" 
i- chaniD) ; 

) 

} 

/** 

* Resumes the broadcast operation. 
•/ 

public synchronized void resume 0 ( 

if (isOnlineO) { 

threadSuspended - fal*«r 
notify O ; 

\ 

else 

throw new illegalThreadStateExceptian 
<obj_name 

+ '": broadcast thread not running for channel-" 
+ chanID) ; 

) 

} 

1 * Teats to see if thread is cunning (i.e. channel ia broadcast ing \ , 
-/ 

protected synchronized boolean isOnline () 1 

return (channelThread J- null) 1 true : false; 

I 
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^ * Initializes broadcasting process. Registers (make payment) with the radio 

* station to obtain the SEK. Set key pair (public/private) . 

* (Sparam pubKey public key of RAS, as givsn by <code>MarconiServer</cod«:>. 

* Sparara privKey private key of RAS. 

protected synchronized boolean init (byte (] pubKey, byte{] privKey) { 
this.publicKey - pubKey; 
this .privateKey - privKey; 
try ( 

System. out .prlntln<obj_name + ".init: contacting RSC at " 

+ host +■ "..."); 
station - (RSC) Naming . lookup ( "//" + this. host 

+■ ";■ + MareoniServer.RMI_FORr 
4- "/mareoni.rsc. station") ; 
sek_id =■ station. enroll (publicKey) ; 
System. out .print In (ob j_name 

+ ".init: public key submitted (sekid-" + sek_id + ' 

) 

catch (Exception e) ( 
return false; 

> 

if (sek_id > -1) { 
return true; 

} 

else { 

return false; 

\ 

} 

I** 

* Adda individual commercial into the channel database. 

« @param " ad_id advertisement id or commercial filename. 
*/ 

protected synchronized ^oid addCommercial (String ad_id) { 

// set date using the time at GMT at 0 hour (midnight) 
Date date - new Date(Timeatamp.get_midnight O ) ; 

if ( 'commereialSchedule.containsKey (date) I { 
vector2 ad_list - ne»t vector2(); 
commercialSchedule.put (date, ad_list) ; 

Vector2 adUList - (Vector2) conunercialSchedule. get (date) ; 
ad_list . addSlement (acUid) ; 

} 

/" 

* Remove* the list of commercials in the database. 

V 

protected synchronized void removeConraercials 0 K 

II set date using the time at GMT at 0 hour (midnight) 
Date date - new Date (Timestamp. get jnidnight <)) ; 

if (commercialSchedule.containsKey(date) ) ( 

Vector2 ad_liat - <Vector2) coraroercialSchedule. get (date) \ 
ad_list . removeAllElementa () ; 

) 

> 
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* Generates a commercial-list file from the channel dat 

* of a List of filenames to be read-in by the advertisement inaertion module. Each 

* file in the list should contain the actual audio data for the commercial playing 

* and its name is added to the database via. <code>addCommercial () </cod«> method. 

* The commercial-List file takes the global multicast address of this station in 

* numerical format appended by ".1st". 

protected synchronized void genCommercialFile O \ 
Date cats - new Date (Tiniest amp. get_midflight ()) ; 

if (commercialSchedule.containsKey {date! I < 
try ( 

File file = new Fi le <g_maddr , get Host Address ( ) - ".1st"); 

printWriter font = new FrmtWnter (new Bur f eredWriter (new FileWriter ( f ile > )> ; 

Vector2 ad_list = (vector2) commercialSchedule .get (date) ; 
3tring[] ad_arr - ad_list . toStringArray O ; 
if <ad_arr !- null) ( 

for lint i - 0; i < ad_arr . length,- i++) ( 

f out. print In ( (ad_arr[i] i- null) ?ad_arr(i] : »"); 

} 

System. out. println(cbj_name +■ " .genCommercialFile : tile updated -* 
+ new Date (> ) ; 

fout . close O ; 

) 

catch (lOException e) { 

) 

y >' 
> ; : 

/** 

* Returns channel statistics. 

* Sreturn channel accounting information packaged in <code>ChannelStatistics<:/code> 

* class. 

protected synchronized ChannelStatistics audit*) { 

return new ChannelStatistics (String. valueOf (chanlD) , rtcpRegistry.getNumMembers O ) ; 

} 



* Reads from a CDP packet and extracts channel information. 

* Gparain cdp the channel description packet to be parsed. 

protected synchronized, void read_cdp (CDPPacket cdp) < 
if (cdp. nana !- null) t 
this. name - cdp. name; 

if (cdp. category i- null) { 

this. category - cdp. category; 

if (cdp. description !- null) ( 

this. description - cdp. description; 

1 

if (cdp. language !- null) { 

this. language - cdp. language; 

> 

if (cdp. origin 1- null) { 

this. origin - cdp. origin; 

if (cdp.HADDH !- null) { 

try ( 
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thi3.g_ma(idr - inetAddreas .getByName (cdp . MADDR) i 

catch (Exception e) { 
i 

^ 

if (cdp. id !» null) { 
this. host - cdp. id; 

) 

if (cdp.SEKLIST != null) { 

if (selt_id >= 0 it sek_id < cdp . SEK1IST , length) { 
if [cdp.SEKLIST[sek_id] != null) { 
SEK = new byte [SEKLEN) ; 

byte[] cemp_hyte = Base6 i -decode (cdp . SEKLISTl s«k_id] . getBytes ()) ; 
System, array-copy (temp_byte, 0, SEK, 0, 

Math. min{temp_byte. length, SEKLEN) ) ? 

> 

) 

1 

if (cdp. date != -1 tfi cdp. schedule !- null) ( 

// set date using the time at GMT at 0 hour {midnight) 
Date date = new Date (Timestamp . get_midnight (cdp. date) ) ; 

// store schedule 

programSchedule. put (date, cdp . schedule) ; 
/* 

* The commercial database design ia not utilized in this version. 

* Instead, refer to genCommercialFile ( I and its related methods for ,* 

* supporting LAIE (local advertisement insertion protocol) . ; i 

commercialSchedule. put (date, new CommercialSchedule () ) ; 



* writes current channel information to a CDP packet. The scheduling 

* information is only done for the current date. Thus the server is not 

* supported to post announcements for future dates. 
* 

* ("return a fully initialized CDP packet. 
V 

protected synchronized CDPPacket write_cdp(> ( 
CDPPacket cdp * new CDPPacket () ; 

// get today's date at 0 hour. 

Date today - new Date(Tiraestamp.get_midnight () ) ; 

/7 copy channel info 

cdp. nana - this. name ; 

cdp. category - this . category; 

cdp. id - String.valueOf (this.chanlD) ; 

cdp. description ■ this. description; 

cdp. origin - this. origin; 

cdp. language - this . Language; 

cdp.MADDR = this.l_p»addr.getHostAddress () ; 

cdp.HFORT - MarconiServer.rHCJORT; 

cdp.MTTL - MarconiServer.LOCAIt_TTL; 

// copy schedule info 

cdp. date - today. get Tirae<) ; 

String ached - (String) this. prograinSchedule . get (today) ; 
cdp. schedule - (ached — null) ? : sched; 
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return cdp; 



/** 

* The <code>ThreadCountManager</code> class implements the operations done 

* on the number of running threads. It defines the maximum number of threads 

* {i.e. channels). It also calculates the announcement interval time by taking 

* number of channels into account. 

* <p> 

* Gauthor -riK. 

■ aversion SRevision: 1.0 $ 

* Ssince prototype 1.0 
*/ 

class ThreadCountManager { 
int threadCount = 0; 

public final Static int MAX_THREADCOUNT - Marconi Server . MAX_CHANNEL5 ; 
final static int maX_SLEEPTIME - £00; 
final static int MIN_SLEEPTIME = 20; 

/** 

* Increments the tbrsad counter. 
*! 

protected boolean addThreadl) { 

if (threadCount < MAX_THREMC0UIIT> i 
threadCount++; 
return true; 

> 

return false; 

} 

/** 

* Decrements the thread counter. 

protected boolean removeThread () { 
if (threadCount ■> 0) { 
threadCount — ; 
return true; 

> 

return false; 

\ 

/"* 

* Tells whether there are no threads. 
V 

protected boolean isEmptyl) { 

return (threadCount — 0» ? true : false; 

> 

/" 

* Returns the number o£ running threads. 
*/ 

protected int getCountO { 
return threadCount; 

) 

' '* Returns each thread's appropriate 3leep time in number of milliseconds. 
■ The more threads running, the less sleep time for each thread. 
*/ 
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protscted int gatSleeoTima ( ) < 

return Mat h. max (M?d<_$LEEP TIME - threadCount * 10, HIK_SLEEPTIME ( ; 
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/* mareoniNet - Internet Radio network 

* Distributed RadiP Antenna Server (RAS) : [Channel Monitoring Applet) 

* $<marconi.ra3.>ChannelMonitorApplet. java -v2 . 0 (prototype version), 1999/05/22 $ 

* ejdkl.2, ~riK. 
*/ 

package marconi . ras ; 

import java. applet .Applet; 
import java.awt.*; 
import java. ut 11 . * ; 
import java.r.et.*; 
import java.rmi.*; 
import java. rmi . server . * ; 

/ * The ChannelMonitorApplet experts a remote object, and periodically contacts RAS 

* to obtain channel accounting information and plots it in graph format. 

public class ChannelMonitorApplet extends Applet 
implements Runnable 1 
final static int INCR - 10; 
final static int GRIDLEFT = 150; 
private static int WIDTH = 600; 
private sratic int HEIGHT *■ 350; 

private static String title = ""; 

final static String obj_name - -mareoni .ras .ChannelMonitorApplet ; 

Thread updateThread - null; »' 

private Hashtable channelTable - new HaahtabLe ( ) ; 
private RAS rasServer = null; 

/** 

* Updates channel status. 
*/ 

public void update () ( 

ChannelStatisticsU channels - null; 
try { 

channels = rasServer.getStatisti.es O ; 

System. out. println(obj_name + '.update: " + new Date I) If 

} 

catch (RemoteException e) ( 

for (int i ■ 0; i < channels, length; ( 

if <channels[i] !- null) ( k,„ ^, . 

ChannelData data - (ChannelData) channelTable. get (channels It] .chan_id) , 
if (data !- null) { 

data.update(channels [i] ) ; 

) 

} 

> 

repaint ( ) ; 



* Periodically update. 
*/ 

public void run() ( 

while (Thread, cur re ntThreadO — updateThread) \ 
try { 

Thread . a leep (10000); 
satch (interruptedException e) { 
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} 

update { ) ; 

} 

} 

public void start () { 

updateThread - new Thread (this) ; 
update Thread. start () ; 

} 

public void stopO ( 

updateThread ■= null; 

) 



/** 

* Tnitialises the applet. 
«/ 

public void initO { 
try { 

// lookup RAS server 

URL URLbase = getDocumentBase I ) ; 

System. out .println (obj_name + ".init: looking up RAS"); 

rasServer = (RAS) Naming. lookup <"//" + URLbase . get Ho at ( ) + " : " 

+ getParameter ("RASPort") 
+ "/rnarconi . raa .MarconiServer" ) ; 

) 

catch (Exception e) { 

e .printStackTrace ( ) ; 

} 

ChannelStatistics [] channels - null; 
try ( 

channels =■ rasServer .getStatistics 0 ; 

System, out. println (obj_name + ".init: " + new DateO); 

I 

catch (RemoteException e) ( 
e . printStackTrace < ) ; 

} 

for (int i - 0; i < channels. length; i-n-) { 

if (channels [i] i- null 44 1 channelTable .containsKey (channels [i] . chan_id) > ( 

channel Table. put (channels [i] .chan_id, new ChannelData (channels [ij .chan_id) ) ; 

I 

} 

3etSackground (Color. white) ; 
aetLayoutduill) ; 

// draw checkboxes 
int i - 0; 

Enumeration enum - channelTable. elements <) ; 
while <enum.hasMoreElements4) ) { 

ChannelData data - (ChannelData) enum. next Element () ; 

Smart Checkbox cb - new SmartCheckbox (data, this) ; 

data. cb - cb; 

add(cb); 

validate)) ; 

cb.setState (data. displayed) ; 
cb.setBounda (10, i++"30+25, 60, 13); 

} 

} 



/** 

* Called when applet is destroyed. 
*/ 
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public void destroy () ( 
> 

/** 

* Paints the panel. 
V 

public void paint (Graphics g] { 

// draw title 

g. setCDlor (Color, black) ; 

g. drawstring ( "Channels monitored:", 10, 10),- 

// draw grid lin«3 
g.setCaloc (Color. darkGray) ; 

for tint i - GRIDLEFT; l < WIDTH; i += 50) ( 
g.drawLineU, 0, i, HEIGHT - SO) ; 

for (int i = 0; i < HEIGHT; i t- 50) { 

g.drawline (GRIDLEFT, i, WIDTH - 50, i) ; 

) 

g.3etColor(Color.blac>() ; 

for (int i - 0; i < HEIGHT; i += 50| { 

int x ■ i / 2; 

if (it >- 100) x - 24; 

else if (x >- 25) x - 17; 

alse x = 10; 

g. drawString (String. i/alueOf (1/2) , GRIDLEFT - x, HEIGHT - 50 - i); 

^ 

// draw channels r ! 

Enumeration enum - channel Table. elements 0 ; 
while (enura.hasMoreElementsO ) { 

CfcannelData data - (ChannelData) enum.nextElement () ; 

int size; 

ChannelStatisticsO updates; 
synchronized (data. updates) ( 

size - data. updates. size [> ; 

updates = new ChannelStatistics [size] ; 

data. updates. copylnto (updates) ; 

I 

g.setColor (data. color) f 
if (data. displayed) ( 

// draw bo* around checkbox if mouac is over Lt 
if (data.cb !» null ** data.cb.haveMouse 0 ) { 
Point p * data.cb.getLocationl) ; 
Dimension d - data.cb.getSizeO ; 
g.drawRect<p.x-l, p.y-1, d.width+4, d.height+4); 
g.drawReet(p.x-2, p.y-2, d.width+4, d.height+4) 

// point to graph for stock 
if (size > 0) { 

g .drawLine (p.x+d.width+2 , p.y+10, GRIDLEFT, 

scale (updates [0] . listenerCount) ) ; 
if (updatestsise - U 1- ™1D ( 

g.drawString (String. valueOf (updates [size - 1] . listenerCount) , 
GRIDLEFT+siie*INCR, 

scale (updates [sise-1] .listenerCount) ) ; 

} 

\ 

} 
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int * =. GRIDLEFT; 
for (int i - Of i < size; { 
if (update* [i] ! " null) ( 

g. £illOval(x-l, scale (updates [i] . listenerCount) -1 , 4, 4); 
if <(i < size - 1) is updatea[i * 1] I- null) < 
q .drawLine (x, scale (updates [i] .listenerCount), 

x + IHCR, scale ( updates [i + 1 1 . listenerCount)) ; 

} 

) 

x 4-- IHCR; 

) 

} 



/* 

* Used to scale y-values. 
*f 

int scale (float y) { 

return HEIGHT - (Lnt) (y*3+.5) - 50; 
//return HEIGHT - (int) (y*2i-.5) - 50; 

\ 



/* 

* Haka sure that moussHera is set properly. 

V 

void setMouseHere (boolean display) { 

Enumeration enum - channelTable. elements ( I ; 
while (enum.tiasMoreEleraents () ) { 

ChannelData data - (ChannelData) enum.nextElement ( ) ; 

data.cb.mouseHere - display; 

} 

} 

/** 

* ChannelData contains stock updates and display information. 
*/ 

class ChannelData { 



/ / channel 
public String id; 

private static int channelCount - 0; 

// update history 

public Vector updates; 

private static int updateCount; 

final static int MAX^UPDRTES ■ 34; 



// display 

public boolean displayed; 
public SmartCheckbox cb; 
public Color eolorj 

private Colort] colortable - {Color. blac*. Color. gray. Color. cyan, 

Color. pink, Color. magenta, Color. orange. 
Color. blue. br ighter 0 , Color. green, 
Color. red. brighter [) , Color. gray); 



* Constructor. 
•/ 

public ChannelData (String id) < 
this. id - id; 

this. color - colorTable [channelCount++ % colorTable . length] ; 
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this. updates = new Voctor (MAX_UFDATES) ; 
displayed = true; 

) 

/* 

* Updates channel 3tatus. 

void update (ChannelStatistics channel) { 
synchronized (updates) { 

if (updates . siae () == max_UPDATES) [ 
updates . removeElementAt (0) ; 

} 

if {updates . size ( ) <: updateCount - 1) ( 

for lint i - updates. sized ; i < updataCount - 1; i++> ( 
updates. addElement (channel) ; 

) 

) 

updates. addElement (channel) ? 
updateCount - updates . 3ize () ; 

) 

} 

/** 

* Resets counters. 
*/ 

public static void reset ( ) { 
updateCount = 0; 
channeLCount 3 0; 

} 



* A smart checkbox that records whether the mouse is over the checkbox. 

"/ 

;la93 sraartChecXbox extends Canvas i 
ChannelData data; 
boolean state - true; 
ChannelMonitorApplet panel; 
boolean mouseHere = false; 

public boolean haveMousel) { 
return mouseHere; 

) 

/** 

* Constructor. 

public SmartChecWbox {ChannelData data, ChannelKonitorApplet p) I 
this. data - data; 
panel - p; 

} 

public bcolean mouaeEnter (Event evt, int x, int y) { 
if (state) ( 

I /panel. setMousaHere (f aLse) ; 
mouaeKere - trua; 
panel. repaint <); 

) 

return false? 

^ 

public boolean mcuseExit (Event evt. int x, int y) { 
if (state) ( 

mouaeHere - false; 
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panel . repaint < I ; 

] 

return false; 

\ 

public boolean mouaeDown (Event evt, int k, int y) I 
if (state) 

state - false; 

else 

state - true; 
mouseHere - state; 
data. displayed = stater- 
repaint O ; 
panel. repaint ( ) ; 
return true; 

) 

public void paint (Graphics g) { 
g.setColor (Color . white) ; 
g.drawLine (4,4, 14, 4) ; 
g.drawLine (4, 4, A, 14) ; 
g.setColor (Color .gray) ; 
g.drawLine (5, 14, 14, 14) ; 
g.drawLine (14, 5, 14, 14) ; 
g.setColor (data. color) ; 
g.fillRect(5,5,8,8>; 
g.setColor (data. color) ; 
g. drawstring ( "Ch-" + data. id, 17, 15); 
g.setColor (Color . white) ; 

iE (state) { , i 

g.fiURectl?, 7, i, 4> 1 

\ 

} 

public void setstate (boolean a) { 
state = s; 
repaint () ; 

) 
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/* macconiNet - Internet Radio Network 

* Distributed Radio Antenna Server IRAS) : [Channel Accounting Data) 

* 5<mareoni.ras.>ChanneXStatistics. java -v2 . 0 (protctype version), 1999/05/22 5 

* Qjdkl.2, -riK. 
*/ 

package marconi . raa ; 

1 * This class encapsulates the channel accounting inf ocmation, such as the number 

* of current listeners. It can be extended to include other kinds cf data for auditing 

* or periodic logging. 

* (Jauthor -riK. 

* aversion $F.evision: 1.0 S 

* (Jsee marconi . ras . channel 

* Ssince prototype vl.O 

public class ChannelStatistica implements java . io. Serialiiable ( 
/•* 

* Channel Id. 
V 

public String chan_id - 

1 * Uaage. The current number of listeners foe tha sp«ci£ied channel. 
V 

public int listener/Count - 0; , * 

/** 1 

* Constructor. 
*/ 

public CliannelStatiatics (String id, int count) { 
chan_id = id; 
listeftercount = count; 
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/* marconiNet - Internet Radio Network 

* Dis-ributed Radio Antenna Server (BA3) : [Commercial Schedule <Jia33j 

* $<marconi ■ ras . >Commercialschedule . java -vl .0 (prototype version), 1998/09/06 3 

* Sjdkl.l.T, -riK. 
*/ 

package marconi.ras; 

import java.io. T ; 
import java.utii.*; 

/** 

* The <code?CommerciaLSchedule</code> class represents a template for schedule of 

* commercial time slots. Currently, the number of commercial breaks each day and 

* the number of advertisement slots for each break are statically set, but it 

* should be extended to be more dynamic. In any event, it provides several APIs 

* for retrieving proper information from the advertisement database. 

* <P> 

* ^author -riK. 

* Aversion $Revision; 1.0 $ 

* dsince prototype vl . 0 
V 

public class CommercialSchedule { 
/* 

* An array of commercial breaks. 
*/ 

private CcmmercialBreaM] breaks; 
/** 

* Number oE breaks per day. 
V 

public int M^BREAKS = 8; 
f 

* Break counter. 
*/ 

private int breakCounter - -1; 
/* 

* Time-slot counter 
*/ 

private int alotCounter - -1; 
/** 

* Creates new instance of commercial schedule. Use default number of breaks. 
*/ 

public CcitunercialScheduleO \ 



breaks - new CoraraercialBreak(N_BREAKSJ ; 

// allocate breaks with slots 
for (int i - 0; i < N_BREAKS; i++) ( 
breaks [i] - new comraercialBreak {) ; 

) 



/** 

* creates new instance of commercial schedule. This cannot be used in this 

* version because the advert iaement registration protocol assumes the default 

* setting anyways. 



} 



* 8paraifi 



freq 



number of breaks per day. 
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public CommercialSchedule (int freq) \ 
u_BREAKS - freq; 

breats ■ new CommercialBreak [N_BREAK5 ) ; 

// allocate breaks with slots 
for (int i = 0; i < S_BREAKS; i++) ( 
breaks [i] ■ new CammercialBreak () ; 

} 

} 

/*» 

* Goes to next commercial hreax. 
*/ 

public void nextBreakn I 

breakCounter = (brealtCounter + 1) * h_breaKS; 
slotCounter - -1; 

! 

/** 

* Gets the next advertisement id in schedule. 
*/ 

public String nextSlctO I 
if (breakCounter < 0) { 
nextBreak ( ) ; 

> 

siotcounter = (slotcaunter + 1) % breaks (breakCounterl .N_SL0TS; 

return breaks [breakCounter] .getCommercial < slotCounterl ; , t 

> r : 

/** 

* Returns the available time 3lot3 for advertisement. Each vector element is 

* associated with a commercial break, which has 8 {default} poaaible slots. 

* These 8 slots are represented by a <eode>E>inary string</code> where a '1' 

* means that the slot is occupied. 

* Breturn a vector of bytes which represents the available commercial slots. 
*/ 

public synchronized Vector getlimeSlots O < 
Vector breakList - new Vector {); 

for (int i • Of i < N_BREAKS; i++) I 

breakList .addElement (breaks [i] . g«t Bitmap 1 1) ; 

} 

return breakList; 

} 

/** 

* Seta the requested time alot for the given advertisement. 
*/ 

public boolean aetTimeSlot (int break_id, int slot_id, String ad_id) ( 
return breaks [break_id] .reaerveSlot (si ot_id, ad_id) ; 

) 

> 

/** 

* Each commercial break consists of the following: 

* «!ul> 

* <li>the number of slots for this break (does not necceaaarily have to 

* be B but the prototype should use this default value) ; 

* <li>array of slots that contains the commercial ids; 

* </ui> 

* <p> 
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* ^author -riK. 

* aversion ^Revision: 1.0 5 

* Ssince prototype vl.O 
*/ 

=lass CommercialBreak ( 
/** 

* The nu.T±>et of commercial slots per each break. 
*/ 

public fi.r-.al int N_SLOT5 = 8; 
!* 

* This prototype version does not use the below parameter... 

private Date breakTime; // beginning of the commercial broak time 
•/ 

/* 

* B-bits ^ra used to represent 3 commercials. Each bit maps to a 30 second 

* commercial. 
*/ 

private int bitmap; 
/' 

* The array of slots that contain advertisement id. 
V 

private String!] slots; 
/* 

* Constructor for commercial break, 
«/ 

□ubl- CommercialBreak () ( 
v. jis. bitmap = 0; 
■..lots ■ new String [N_SLQ7S J; 

\ 

f k 

* Check to see if all the slots are full. 
V 

protected synchronized boolean isFullO { 

return (bitmap >- (1 << N_SL0T5) - 1) ? true : false; 

> 

I* 

* Get the bitmap representation of the slots. 
V 

protected. String getBitmapO ( 

return. Integer. toBinaryString (bitmap) ; 

1 

* set the bit for the requested time slot. Slots are of course 0-basad (0-7). 
*/ 

protected synchronised boolean reserveSlot (int slot, String ad_id> K 
if (isFullO) { 
return false; 

int slot_bit - 1 << slot; 
if ((bitmap i slOt_bit) > 0) { 
return false; 

) 

else { 
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return trua; 
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> 

} 

/* 

* Reserve any available time slot; 

protected synchronized boolean reserves 
if <this.isFull<) ) { 
return false; 

) 

boolean success = false; 
for (int i = 0; i < N_SLOTS; i++> { 
if (slots [i] =- null) { 

bitmap l=> 1 << i; 

slots [i] - ad_id; 

success = true; 

break; 



/* 

* Get the specific commercial. 
'/ 

protected synchronized String getCommerciai (int slot) { 
return slots [slot I; 

> 



return success; 



} 
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t* luarconiNet - Internet Radio W«tworlc 

* Distributed Radio Antenna Server (PAS) : (RA5 Action Handler] 

» S<marooni . ras . >RASActionHandler . java -v2 . 0 (prototype version), 1998/02/17 S 

* Sjdkl.2, six. 
•/ 

package marconi.ras; 

import java.awt.*; 
import java . awt , event . *; 

^* This class handles two action commends, particularly <code=>Ok</code> and 

* <code>Toggle</code> buttons. 
*/ 

public class RASActionHandler ( 

public static ActionListenec buttonControl =• new ActionListener ( ) { 
public void actionPerformed(ActionEvent e) { 
String command - e .getActionCommand ( ) ; 
if < command. equals ("Ok") ) < 

RASControls.processComniandO ; 

else if (conmand. equals ("Toggle")) { 
RASControls .toggleButton () ; 

else if (command, equals ("Add Commercial")) ( 
ADControls.processAddO ; 

else if ( command. equaLa ("Submit Commercials")) ( 
ADControLa .proeessSubmit () ; 

else if (command. equals { "Remove Commercials "> ) { 
ADControls .prc-cessRemoveO ; 

} 

) 

I; 

public static ActionListener liatControl - new ActionListener 0 { 
public void aetionPerformed(ActionEvsnt e) ( 

if (RASContcols. act i onDisplay. equals ("Add") ) { 
RASControls . entry_l . setTeit 

( RASD i rect o ry . di recto r yLis t_l .getltem 
(RASDirectory.directoryLi3t_l.getSelectedIndex () ) ) ; 

} 

} 

}?. 
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/* marcanitfet - Internet Radio Network 

* Distributed Radio Antenna Servar (RAS) : [RAS GUT Controls] 

* s<marconi.ra3.?RASControls. java -v2 . 0 (prototype version), 1999/02/15 $ 

* Sjdkl.2, -rLK. 
*/ 

package marconi.raa; 

import ^ava.avt.*; 
import java.awt .event . *; 
import java.ut.il , *r 



* Thia panel contains user interfaces to the applet. 
*/ 

public class RASControls extends Panel { 
public static RASMgrApplet owner; 
public static Choice ids; 
public static TextField entry.l; 
public static Button button_l; 
public static Button button_2; 
public static String actionDisplay; 
private static int WIDTH - 600; 
private static int HEIGHT - 50; 



» instantiates the control panel. 
*/ 

public RASControla (RASMgrApplet main) ( 
owner ~ main; 
actionDisplay - "Add"; 

GridBagLayout grid - new GridBagLayout O ; 
GridBagConstrainta cons - new GridBagConstraints <) ; 
setLayout (grid) ; 

cons. fill = GridBagConstrainta. NONE; 
cons.weightx - 0.0; 

// define toggle button 

button_l = new Button (" " + actionDisplay + " ")f 
butten_l . setActionCoimnand ("Toggle") i 

but ton_l . addAct i onLi sterer (RAS Act i onHandle r . bu tt onContro 1 ) ; 

button_l . setBackground (Color . lightGray) ; 

// button_l.setlac!cground(Color. black) ; 

button_l . setForeground (Color .black) ; 

/ / button_l . aetEoreground (Color . red) ; 

add (butt on_l) ; 

validate ( ] ; 



// channel id 

ids - new Choice < ) > 

updatelDsO; 

grid. setConstraints (ids, cons); 
ids. sBtFareground(Color. black) ; 

// ids. setroreground (Color. yellow. darker <) ) ; 

ids . setBackgr ound (Color . lightGray) f 

/ / ida . setBackground (Color .black) ; 

add (ids] ; 

validate O; 

// selected station (multicast address + name) 

entry_l - new TextFieldOO) ; 

grid. setConstraints (entry_l, cons) ; 

entry_l .set Foreground (Color. blaclt) ; 
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f / en try_i , aetForeground (Color .yeLlow.di 

entry_l- 3etBacl <9round (Color, gray-brighter (] ) ; 

entry_l.setBackground(Color.blue,darKer () .darkerO) ; 
add(entry_ll; 
validate (); 

// add global to local 

oans.gridwidth - GndBagConatraints. REMAINDER; 
button_2 =■ new Button (" Ok "); 
button_2 . setAct i onCommand < "Ok" ) ; 

fcutton_2.addActionListener (RASAetionHandler .buttonCcntrol) ; 

fcutton_2 .setBackground (Color. lightGray) ; 

/; button_2 . setBackground (Color .black ) ; 

fcutton__2.setForeground (Color .black) ; 

/ / button_2 . setForegroundl Color. red) ; 

qiid.setConstraints (button_2, cons) ; 

add ( butt on_2) ; 

validate 0; 



// resize 

setSize (WIDTH, HEIGHT); 



* Cerriea,, out the specified action. 

public static void processCommandO { 

// if action is "Add" .* 
if (actionDisplay .equals ("Add") ) ( , E 

String textfield =■ entry_l .getText I > ; 

String id_3tr - ids.getSelectedltenO ; 

if (textfield. indeK0f(", ") > 0 S< id_str !- null) { 

StringTokenizer dir - new StringTokeniser (textfield, ", "1; 
String ma - dir. next Token () ; 
String name - dir .next Token () ; 
int id - Integer. parselnt (id_str( ; 
if ( owner. addChannel (id, ma)) ( 

owner. showMessage( "Added new channel...", false); 
update ids () ; 

) 

else ( 

owner. showMeasage( "Channel could not be added...", true); 

} 

) 

else ( 

owner. showMessage ("Select a station from global directory.", true); 

> 



// if action is "Remove* 
else if (actionDisplay. equals ("Remove*) ) ( 
String id_atr - ids.getSelectedltemO ; 

if (id_str I- null) { 

int id - Integer.parselnt(id_str); 
if (owner. removeChannel (id) ) { 

owner. ahowMessage ("Removed channel " + id + false); 

update IDs () ; 

) 

else { ... 
owner. showMeasage ("Channel could not be removed...", true); 

} 
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) 

else 4 

owner . showHes sage [ "No channel to remove..-"- true); 

} 

> 

!l clear input fields 
entry_l. set Text ("") ; 

t 

/ * Implements the toggle mechanism for the control button* 
*/ 

public static void toggleButtoo ( ) { 

// if outton label says "Add", change it to "Remove" 
if (actionDisplay .equals ( "Add") ) { 
dCtionDisplay - "Remove"; 

owner. showMessage ("Please select a channel to remove..-", falsa); 
updatelDal); 

} 

// if button label says "Remove", change it to "Add" 
else if ( a ctionDisplay.equals("Remove"> ) ( 
actionDisplay - "Add*; 

owner .ahowMeaaage ("PLeaae select a station to add...", false); 
updateiDs ( ) ; 

) 

button_l . setLabel (actionDiaplay) ; , < 

) 

/" 

* updates available channel id3. 
V 

public static void updatelDa () { 
ids . removeAllO ; 

if (actionDisplay. equals ("Remove") ) { 

for (int i - 0; i < owner. ehannellDa. length; H-+) [ 
if (owner .channel IDs [i] ) { 

ids - add (String . valueof (i) ) ; 

} 

} 

> 

else i , 

for (int i - 0; i < owner.channellDa.lengt.il { 
if (! owner. channel IDs ti] ) { 

ids. add (St ring. valueOf (i> 1 ; 

} 

> 

} 

) 
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/* raarconiNet - internet RzSlo Network 

* Distributed Radio Antenna Setvec (RAS) : IRAS Directory Controls] 

* S<raarconi.ras.:>RASDirectoiry. java -v2 . 0 [prototype version), 1999/02/15 $ 

* ejdkl.2, 
*/ 

package marconi.raa; 

import java.awt.*; 

import java.awt .event.*; 

import java.util. Enumeration; 

import java.io."; 

import marconi.util. *: 

/** 

* This panel contains user interfaces to the applet. 
-/ 

public class RASDi rectory extends Panel 
implements Runnable ( 

* This thread periodically downloads global channel announcement 3 (CAP) cache, 
private Thread g_di rectorylhread = null; 

» This thread updates the announcements for the Locally supported channels. 
*/ 

private Thread l_di rectory Thread - null; 
/** 

* The global announcement update interval. 
*/ 

private static long G_UPDATE = 20000; 
/*» 

* The local announcement update interval. 

V 

private static long L_UPDfiTE - 20000; 

public static RASMgrApplet owner; 
public static Label label_l; 
public static List directoryList_l; 
public static Label label_2; 
public static List directoryList_2; 
private static int WIDTH - 600; 
private static int HEIGHT - 200; 

/" 

* The tile dump. 
*/ 

public final static File file - new File<"_mapsta"> ; 
/»* 

* Instantiates the directory display panel. 
*/ 

public RASDirectory (RASMgrApplet main) { 
owner ■ main; 

GridEagLayout grid - new Grid&agLayout () ; 
GridEagConstraints cons ™ new GridBagConstraints () ; 
setLayout (grid) ; 

cons. fill - GridBagConstraints. NONE; 
setFcnt(new Font ( "Helvetica", Font. BOLD, 24)); 
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// label 1 
cona. weig 1 ** - 1.0; 
iabel_l - new LafieM); 

label— 1 . aetText (* Global Channel directory ") ; 

grid. setConstrainta (label_l, consl ? 

Iabel_l.aetForeground(Color. black! ; 

// label_l . setForeground (Color .white) ; 

add(label_l); 

validate <) ; 

If label 2 

cons .gridwidth = GcidBagConstraints . REMAINDER; 
Label_2 - new Label <); 

label_2 . setXext ( " Local Channel Directory ") ; 

grid. setConstraint3 <label_2, cons) ; 

label_2 . setForeground (Color . black) ; 

f / label_2 . aetForeground <Color .white) ; 

add(label_2) ; 

validate () ; 

setFont (new Font ("Helvetica", Font . PLAIN, 14)); 
// list 1 - globaL 

cons .gridwidth = GridBagConatraints. RELATIVE; 
dir«ctc-ryList_l = new List (10, false); 

directoryLiat^l . addActionLiatener (RASActicnHandler. listControl) ? 
grid . aetConstraints (directoryLi3t_l, cons) ; 
directory Li st_i . setfaragrouna (color .Clack) ; 
directoryList_I . setBackground (Color. white) ; 

// directoryHst_l .setForeground<Color. yellow. brighter (>) ; < 

// directoryList_1.3etBackground(Color.darkGray) ; ; 

add (directoryLiat_l) ; 
validate <); 

// list 2 - local 

cons .gridwidth - GridBagConatraints. REMAINDER; 
directoryLiat_2 - new List (10, false); 

// directoryLiat_2 .add&ctionliatener (RASActionHandler. LietControl) ; 

grid. aetConstrainta (directoryLiat_2, cons) ; 
directoryList_2 . setForeground (Color. black) ; 
directoryList_2. setBackground (Color. white) ; 

// directoryList_2 .setForeground (Color. yellow. brighter ( > ) ; 

// directoryli3t_2 .setBackground (Color. darkGrayJ ; 

add (directoryLiat_2) ; 
validate () ; 

// resize 

aatSiia (WIDTH, HEEGKT) ; 



/** 

* Starts the directory update. 

*■/ 

public void start () ( 

g_cireetcryThread - new Thread (this) j 
g_directoryThread.atart O i 
l_directorylhread » new Thread ( this ) ; 
L_directoryThread. start { ) ; 



start < > ; 



} 



The run methods for the two threads. 
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putilic void runll ( 

// global directory 

while (Thread. currentThread () == g_directoryThread) { 
PrifltWriter fout =- null; 

tey I 

Thread. sleep <G_UPDATS) ; 

fout - new PrintWriter (new Buf feredWriter (new FileWriter (f ile) ) ) ; 
Enumeration enum - owner ■ rasServer .downloadCAP (false) .elements <) ; 
vector2 ip_addr = neu Vectar2(); ■ 
Vector2 name = new Vector2 () ; 

while (enum.hasMoreElementa 0 ) ( 

CDPPacltet cdp = (CDPPacket) enure, next Element () ; 

ip_addr .addElenent (cdp.MADDRJ ; 

name . addElement (cdp. name) ; 

fout .print In (cdp.MADDR " * + cdp. name); 

) ■ 

displayDi rectory <ip_addr .toStringArray ( ) , nair.e . toStringArray () 1 ; 
fout.clc3e () ; 

) 

catch (Exception e) ( 

e.printStackTrace I ) j 

> 

} 

// local directory .> 
while (Thread. currentThceadO — l_directoryThread) ( r > 
try { 

Thread. sleep <l_ufdate) ; 

Enumeration enum = owner. rasServer . downloadCAP (true) .elements O ; 
Vector2 ip_addr - new Vectcr2(); 
Uector2 name - new vector2(); 
Vector2 id - new Vecte>r2 < ) ; 

while (enum.hasMoreElements () ) ( 

CDPPacket cdp - (CDPPacket) enum.nextEleraent ( } ; 
ip_addr . addElement (cdp .MADDR) ; 
name. addElement (cdp. name) ; 
id. addElement (cdp. id) ; 

) 

displayDirectory ( ip_addr . toStringArray ( ) , name. toStringArray [ ) , 
id. toStringArray () > ; 

} 

catch (Exception a) { 

} 

> 

} 

protected static void diaplayDirectory [String [) ip_addr, String!] name) ( 

if (diEectoryLi3t_l.getitenicount() > 0) 

directoryLiat_l .removaAll () ; 
for lint i - Of i < ip_addr . length; ( 

directoryList_l .add (ip_addr[i] <-","+ name(i]); 

} 

) 

protected static void diaplayDirectory (String[] ip_addr, StringU name, String!) id) ( 
if (directoryList_2.getltemCount() > 0) 

direct oryList_2 . removeAU ( ) ; 
for (ir.t i - 0; i < owner. KAX_CHAITNELS; i++) ( 
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directoryList_2. add (String. valuaOf (i) > f 

for (int i - 0; i_ < ip_addr . length; 1+t) \ 

dicectoryHst_2.replaceItem(id[i] + " " + ip_addr[i) name!il ( 
Integer . parse Int (id [ i ] ) ) ; 

} 

} 

prcteeted static void displayDirectory (String ip_addr, String name) ( 
directoryList_l , acid I ip_addr + * , " + name) ; 

) 

protected static void di aplayDi rectory ( String ip_addr, String name. String id) { 
, directorylist_2.replacaItemUd + ip_addr + " , " + name, Integer. F ars«Int (id) ) ; 
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/* mareonislet - Internet Raflio Network 

* Distributed Radio Antenna Server (FAS) : [RAS Manager Interface! 

* s<marconi.taa.>RASManageir. java -v2.0 (prototype version!, 1999/02/15 $ 

* ajdkl-2, -riK. 
*/ 

package marconi , cas; 
import java.rrai.*; 
/** 

* This interface ia provided for the EUlS to write alarming texts at the remote manager. 

* (?auth.or -riK. 

* aversion SReviaion: 1.0 $ 

* @see marconi . ras.MarconiServer 

* (Jsince prototype wl.O 
*/ 

public interface RASManager extends Remote { 
/** 

* Write various messages (error messages). 
*/ 

public vgic showHessage (String mag, boolean blink) 
throws RemoteException; 

} 
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'* marconiNet - Ir.ternet Radio Network 

« Distributed Hadio Antanna Sstvst IRAS) : (SAS Heasageboard Displayl 

* 5<marconi.ra3.>BASMe33ageBoard. java -v2 . 0 (pcototype version), 1999/02/15 S 
« 9 jdlel- 2# -riK. 

■/ 

lackage marconi.ras; 

.mport java. awn. *j 
import java.net.*; 
Import java. applet.*; 

* This message boz&d is used to display messages in a scrolling fashion. 

* The content of the message is updated by directly accessing and changing 

* the public variables <code>text</code> and <code>blink</code> . 

* If <codeJbLink</code> is set to <code>true</coda>, the message stored in 

* <code>text</code> will scroll and also ! blink!; this feature is 

* particularly for alarm (error) messages. 

aublic class RASMessageBoard extends Applet 
implements ftunnable ( 

// publically accessable vars 
public String text - ""; 
public boolean blink = false; 



// awt vats 

int shiftCnt - 0 ; 

private Tent font; 

private static Color fgcolor - Color. blue; 
private static Color bgcolor - Color . lightGray; 
private Color color - fgcolor; 
private Image of fScr Image - r.ull; 
private Graphics off ScrGraphica = null; 
private Dimension offSerSize => null; 

Thread thread - null; 



' + Even though this object extends from an applet, it is not to be 

* the mam applet and thus is instantiated via a constructor,- you may 

* set it to display some initial text; 

public RASMessageBoard (String initial_t**t) \ 

// initialize text field 
this. taut - initial_text; 



// measure screen width 
shiftCnt - getSiseO .width; 



// setup font 

font - new Fontf-Helvetica", Font. PLAIN, 16); 
setFont (font) ; 
start <); 



* Start the thread; 
'/ 

public void start () i 

if (thread — null) { 

thread - new Thread (this) ; 
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thread. start () ; 

) 

I 

/** 

* Stop -he thread; 
*/ 

public '/oid stop() ( 
thread = null; 

) 

/<■* 

* Tr.react body; blinking feature is implemented by toggling text color 

* b/w background and fareground here after each pause; 

public void run() ( 
int i = 0; 

while (Thread, cur rer*tTlir*ad() == thread) ( 

// pause 
try { 

Thread. cur rentThread ( ) .sleep<200> ; 

) 

catch (InterrupeedException e) { 
) 

// blink -> toggle colors b/w black and yellow 

//it remains black for 2 pau3e periods and yellow for 4 periods 
// otherwise -> stay yellow 
if (blink) 

color = (!*■+ < 2) ? bgcolor : fgcolor; 

else 

color ■ fgcolor; 

// update drawing 
repaint <) ; 

i = (i > 61 7 0:1; 

} 

} 

/** 

* Update display (move the message to the left) . 
V 

public synchronized void update (Graphics g) \ 
FontMetries fMetrie; 
fMetrie - getFont Metrics (font) ; 
Dimension d - get Size (); 

// creata off-screen image 

i£( (off Scr Image — null) II (d. width !- off ScrSise. width) II 
(d. height !- of fScrSize. height > ) < 
offScrlmage - createlmage<d. width, d. height); 
offscrsize ■ d; 

of f ScrGraphiea » of fser Image . getGraphics () ; 
of f ScrGraphiea. oetFont (font) j 

) 

// setup off-screen image 

off ScrGraphiea. setColor (bgcolor) ; 

of f ScrGraphiea. f i HRect (0, 0, d. width, d. height); 

of f ScrGraphiea . setColor ( color) ; 

of f ScrGraphiea. setFont (f ont ) ; 

if KahiftCnt + fMetrie. atringWidth (text) ) <- OJ 
shiftCnt • d. width; 
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// shift left k write message 
ahiftCnt = shrftCnt - 5; 

of fScrGraphics. drawstring (text, shiftCnt, (int) (d. height * 0.65) t; 
g.drawimage (of fScr Image, 0, 0, null); 

) 

> 
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/* marconiNet - internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [RAS Manager Applet! 

* $<mareoni.ras.>RASMgrAppl*t. java -v2 . 0 (prototype version), 1999/02/15 S 

* Ujdtel.2, -riK. 
*/ 

package marconi . ras ; 

Import java . applet .* ; 
import java.awt.*; 
import jova.util.*/ 
import java . net . URL; 
import java.rmi.*; 
import java. rmi . server . *; 

/** 

* This applet is used by a RAS manager (operator) who monitors and configures 

* the MarconiServer . 

* @author -ciK. 

* Aversion SRevision: 1.0 S 

* Gsee marconi . ras -Marconi Server 

* @since prototype vl . 0 
"/ 

public class RASMgrApplet extends Applet 

implements RASManager, java . io . Serializable { 

// misceLLeneious variables 
private static int width = 0; 
private static int height - 0; 
protected FAS rasserver - null; 
protected int MAX_CHANNELS - 0; 
protected static boolean [] channellDs; 

final static String ob]_name = "marconi . ras . RASMgrApplet"; 

// tools 

RASDirectory directory = mill; 
RASControls controls = null; 
ADControla ad_controla - null; 
RASMea sage Board msgBoard = null; 

/** 

* Initialize the applet and setup display area. 
*/ 

public void initO { 
try ( 

width - Integer. paraelnt (getParameter < "APPLWIDTH" ) ) f 
height - Integer. parselnt (getParameter ("APPLHEIGHT") ) ; 

// lookup RAS (MareoniSarver) 
UR1 URlbaS* - gatDocumentBaae () ; 

System. out. println(obj_narae + ".init: locating FAS"); 

rasServer - (RAS) Naming. lookupC//" + URlbass.getHost O + ":" 

+ getParameterCRASPort") 
+ "/marconi. raa. MarconiServer*) j 

// init variables 

MAX.CHANNEIS = MarconiSarver . MAX_CHA1TNELS ; 

} 

catch (Exception e) { 
i I fatal error 

Sy stem. err. print In (obj_name + ".init: "); 

« , printStaclcTrace ( ) ; 

} 
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channel""* - new boolean (HAK_CHANNELS] ? 
for (int i. - 0; i < channellDa . lenuth; i++) 1 
channellDa [il - false; 

> 

i! draw display area 
setupDiaplayO; 



/** 

* Display the applet. 
V 

public void setupDisplay () { 
Label label_l; 

setBackgrcund (Color .lightGray) ; 

directory - new RASDirectory ( this ) ; 
controls = new RASControls (this) ; 
ad_cantrol9 = new ADControla ( this) ; 

msgBoard = new RASMessageBoard <" initializing RAS . . . " 
GridBagLayout grid = new GridBagLayout [ ) ; 
GridBagConstraints cons = new GridBagConatrainta 0 ; 

/'/ setup grid 

inc rowHeightatl - {10, 200, 50, 200, 90}; 
grid.rowHelghts * rowHeights; 
setLayout (grid) ; 

cona.fill - Gri.dBagConatraint9.B0TH; 
// label 1 

Font font - new Font ( "Arial " , Font. BOLD, 24); 
aetFont(font); 

cons.gridwidth - GridBagConatrainta .REMAINDER; 
lab«l_l = new Label ("- RAS MANAGER -", Label. CENTER) 
grid.3etConatraints <label_l, cans) ; 
label_l .setForeground (Color .black) ; 
add(label_l> ; 
validate () ; 

setFont (n«w Font ( "Arial", Font. PLAIN, 14)); 
!f add directory lists 

cons.gridwidth - GridBagConstraint a . REMAINDER; 
cons .weight x - 1.0; 
cona .gridheight - 1; 

grid . setConatraint 3 (directory, cona) ; 
add (directory) ; 
validate <); 

// add controls 

cons.gridwidth - GridBagConstraints . REMAINDER; 

cona. weight* - 1.0; 

cona. gridheight - 1; 

grid.aetConatraints (controls, cons) ; 

add (controls) ; 

validate*); 

(/ add ad-insertion controls 

cons.gridwidth - GridBagConstraints . remainder; 

cons.weightx -1,0; 

cons. gridheight - 1; 

grid.setCanstrainta (ad_controls, cons) ; 
add(ad_Controls) ; 
validate <) ; 
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// add message scroller board 

cor.a.gndwidth - GridBagConstraints . REMAINDER; 

cons.weightx =1.0; 

cons. weighty - 1.0; 

cons.gndheight = 1; 

grid. setConstraints (msgBoard, eor.sl ; 

add (msgBoard) ; 

validate*) ; 

resize [width, height); 

\ 

t" 

* Close down the server when closing applet. 
*/ 

public void destroy!) ( 

if (rasServer 1= null) ( 
try { 

rasServer .shutdown!) ; 
remove (directory) ; 
remove (msgBoard) ; 
remove (controls) ; 

) 

catch {RemoteException e) { 
e .printStacKTrace 1 ) ; 

} 

) 

) 

/*<■ 

* Register channel with the server. 
*/ 

public boolean addchannel {int id. String ip) ( 
boolean status - false; 
try { 

status = ra6Server.registerChannel<id, ip) ; 

) 

catch (RemoteException e) { 
e. print St aeJtT race <) ; 

> 

if (status) { 

channellDs [id] - true? 
update_ctrls O f 

} 

return status; 

) 

/** 

* Remove channel frwft the server. 
*/ 

public boolean reraoveChannel (int id) ( 
boolean status - false; 
try { 

status - rasServer . rereoveChannel (id) ; 

> 

catch (RemoteException e) I 

} 

if (status) { 

channellDa [id] - false; 
update_ctrls O ; 

} 

return status; 
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) 

/*» 

* Update tools upon action taken - 
"/ 

private void update_ctrls ( ) { 

// controls, apdatelDs 0 ; 

ad_contrcls.updateIDs () ; 

> 

/** 

* Write various messaces (error messages). 
*/' 

public void showHessage [String msg, boolean blink) { 
magBoard.text = mag; 
msgBoard. blink = blink; 

I 

/*, 

* Return applet information. 
*/ 

pub Lie String get Applet Info O f 

return "RAS configuration/management tool"; 

) 
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/* marconiWst - internet Radio network 

* Distributed Radio Antenna Server (RA5) : [RTSP Server Controller] 

* $<rr.arconi.ra3.>RTSPServerControL. java -v2 . 0 (prototype version), 1998/1/12 $ 

* Ujdkl.2, ~riK. 
*/ 

package marconi.ras; 

import java.io."; 
import java.r.et.*; 
import java.uti.1.*; 

/** 

* This class provides interfaces to manipulate the remote RTSPServer. 

* <p> 

* Sauthor -riK. 

* Aversion SRevision: 1.0 5 

* Usee marcani.raa , MarconiServer 

* @since prototype 1.0 
*/ 

public class RTSPServerControl { 
/* 

* RTSPServer private info. 

private final static String obj_name = "marconi .ras .RTSPServerControl*; 
private final static int T0R_0FFSET - 0i 
private final static int M_OFF5ET - 4; 
private final static int LMjOFFSET - 3; 
private final static int PA1H_CFF5ET - 12; 



/** 

* The RTSPServer Host. 
*/ 

protected String hostname; 
/** 

* The RTSPServer port. 

*/ 

protected int port; 
/* 

* TCP-Client resources for communicating with the RTSPServer. 
V 

private Socket rtsp_sock - null; 

private Suf feredlnputStream rtap_in - null; 

private Buf feredOutputStreara rtsp_out - null; 

/** 

" Type of request field value <code>start</cade>. 
*/ 

protected final static byte TOR_START - 1; 

* ' * Type of request field value <code>atop</code>. 
*/ 

protected final static byte TOR_ST0P - 2; 

^ * Type of request field value <code>commercial</code>. 
protected final static byte TOR_COMMERCIAL - 3; 
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/»* 

* Returned status value <code>o*</code> . 
*/ 

protected final static byte STRTUS_0K - 0; 
/** 

* Returned status value <code>erroE</code> . 
*/ 

protected final static byte STATUS_ERR = 1; 
/** 

* Returned status value <code>duplicate</code> . 
*/ 

protected final static byte STATU3JDUP - 2; 
/** 

* Returned status value <code>states full</ccde>. 
*/ 

protected final static byte STATUS_FUL - 3; 
/** 

* ihe number of bytes returned by RTSPServer. 
V 

protected final static int R£CEIPT_LEN = 1; 
/** 

* Creates an object that will interface with the RTSPServer. 
-/ 

public RTSPServerControl (String rtsp_h, int rtsp_p> i <» 
this. hostname = rtsp_h; I; 
this. port - rtsp_p; 
try { 

this.rt3p_sock. - new Socket (rtsp_h, rtsp_p> ; 

thi3.rtsp_in - new Buf feredlnputStream (rtsp_soc.lt . <jetInputStE«ain< ) ) ; 
this.rtsp_out - new Buf f eredOutputStream ( rtsp_sock ,getOutputStreara< ) ) ; 

} . 

catch (lOException e> { 

} 

) 

/** 

* Signals the RTSPServer to start a new thread to support the specified channel. 

* Pparsra g_maddr global multicast address. 

* @param l_madelr local multicast address. 

* Greturn byte representing the status returned from RTSPServer. 
V 

public byte startChannel ( met Address global_addr, InetAddress local_addr) { 
byte [ ] requestPkt ; 
byte (J receiptFkt; 
int n ■ 0; 

// compose outgoing packet & send 
requestPkt - sncod* [TOR_START, 

global_addr. get Address ( ) , 

Local_addr .getAddreaaO , 

null) ; 

try { 

rtsp_out .write (requestPfct, 0, requestPfct. length) ; 

catch (lOException e) ( 

Sy stem. err. print In (obj_name *■ * .startChannel: " -t- e.getMessage () > ; 
« .print StackTrace ( ) ; 

y 
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/ / read the status returned by RTSPServer 
receiptPkt - new byte [H£CEIPT_LEN] ; 
try { 

n = rt3p_in.read(receiptPkt, 0, RECEIPT^ LEN) ; 

t 

catch (lOBxception «) { 

System. err. println(ob j_name + " . atartChannel : " + e . getMessage ( >> ; 
e . printStackTrace { ) ; 

if (n < RECBIPT^LEN) { 

System. err. print In <obj_name + " . startChannel : returned byte is corrupted. ); 
return (STATUS_ERRI ; 

I 

// return status 
return ( reeeiptPkt [0] ) ; 

1 

/ * Signals the RTSPServer to stop the specified channel. 

* @param l_maddr Local multicast address. 

* (? return byte representing the status returned from RTSPServer. 
*/ 

public byte stopChannel ( Inet Address local_addr> ( 
byted requeatFktj 
byte(J receiptPkt; 

int n - 0; , ' 

II compose outgoing packet 4 send 

requestPkt - encode <TOR_STOP, noil, loeal_addr . getAddress < ) , null); 
try { 

rtsp_out. write (requestPkt, 0, reque3tPkt . length) ; 

} 

catch (iOException el ( 

System. err. println lohj_name + ".stopChannel: " + e .getMessage ! ) ) ; 
e . printStackTrace ( ) ; 

) 

It read the status returned by RTSPServer 
receiptPkt = new byte IRECEIPT^LEN] ; 
try \ 

n = rtsp_in. read (receiptPkt, 0, RECEIPT_L£N> ; 

catch (iOException e) ( 

System. err. println(cbj_name + • . atopChannel : " + e. getMessage () ) ; 
e.printStackTraceO ; 

) 

if (n < RSCEIPT_LBN) ( 

System. err. println(cbj_na«e + ".stopChannel: returned byte is corrupted. ); 
return ( STATUS_ERR) ; 

) 

II return status 
return < receiptPkt [0 ] > ; 

) 

/** . , 

* Signals the RTSPServer to play the given commercial. 

* Qparan l_maddr Local multicast address. 

* Gparam path commercial file path. 

* Sreturn byte representing the status returned from RTSPServer. 
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V 

public byte piayCommereial I InetAddress local_addr r string path) { 
fcyteU rcquoatPkt; 
fcytetl receiptPkt; 
int n = Of 

II compose outgoing packet & send 

requestPfct - encode (T0R_C0MMERCIAL, null, loca±_addr . get-Address ( ( , path); 
try { 

rtsp_out .write (requestPkt, 0, requestPkt . length) ; 

) 

catch (IOException e> ( 

System, err. println i obj_r.ame + " . playCommerc Lai : " + e . getMessage ( ) I ; 
e.printStackTrace () ; 

} 

// tread the status returned by RTSPServer 
receiptPkt = new byte IR£CEIPT_LEN] ; 
try < 

n = rtsp_in. read (receiptPkt, 0, RECEIPT_LEN) ; 

> 

catch (lOException e) { 

System. err .println (obj_name 

+ " .playComrnercial: " + e.getMessageO ) ; 
©.print St ackTrace () ; 

> 

if <n < RECEIFT_LEN) ( 

System . err . println lob j_name 

+ ".playCanuuerical: returned byte is corrupted.") ; f i 
return (STATtfS_ERR) ,- r I 

} 

// return status 
return (receiptPkt [0] ) ; 

I 

/" 

* Encodes the input parameters into a TCP packet. 

* Gparam tor type of request. 

* @parara m_addr global multicast address for a station. 

* Gparant lm_addr local multicast address for a station. 

* Sparara path commercial file. 

* @ return the encoded byte array buffer. 
*/ 

static byte[] encode lint tor, byte[] m_addr, byte[] lm_addr. String path) ( 
int path_len - (tor — TOR^COMMERCIAl) ? path, length < ) : 0; 
byte(] buffer - new byte [PATH_OFF SET + 

((tor — TOR_COMMERCrAl) ? path_len : 1)]; 

// type of request 

buffer [TOIL.OFFSET * 0] - (byte) ((tor « 16) >» 24); 
buffer [TOF_OFFSET + 1] - (byte) ((tor « 24) »> 24); 

I! path length 

buffer [TOH^OFFSET + 2) - (byte) (<path_len « 16) >» 24); 
buffer [TOF_OFFSET + 3] - (byte) ( (path_len « 24) »> 24); 

// M: global multicast address 
if (tor — 1) { 

System. arraycopy (m_addr, 0, buffer, H_OFFSET, m_addr. length) ; 

} 

// LM: local multicast address 
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System. arraycopy <lm_addr, o r buffer, LM_OFF5ET, lm_a< 

// commercial fi-la path... 
if (tor -= 3) { 

byte i ] pathbuf - path . getBytes ( ) ; 

for (int i - 0; i < pathbuf .length; i++l { 
buffer (12 + i] - pathbuf [i]; 

) 

) 

return buffer; 

) 

/" 

* Decode the statu3 value. 
*/ 

public static String decodeStatus (byte status I 1 
switch (status) { 
case 0: return "OK"; 
case 1: return "ERROR"; 
case 2; return "DUPLICATE"; 
case 3: return "STATES_FULL" ; 
default: return "UNKNOWN_3IATUS=* + status; 
J 

) 
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/* marconiNeC - Internet Radio Network 

* Distributed Internet Radio Server (DIRS ) s (LAS interface] 

« S<marconi.^LASo ava -vl . 0 (prototype version), 98/8/19. 

* Gjdlcl.2, ~riK. 
*/ 

package mareoni . ras; 

import java.rm:..*; 
import java.util. Vector; 

^ * The LAS (local advertisement server) remote interface provides interfaces 

* for the advertising company, to store and broadcast local commercials. 
*/ 

public interface LAS extends Remcte { 

// public int uploadCommercial <byte{] file) 
// throws RemoteException; 

// public; Vector rev iewTime Slots (int channel) 
// throws RemoteException; 



/** 

* Tell the od server to reserve a alot. 



// public boolean rmycommercialTime (int channel, String ao\_id) 
// throws RemoteException; 
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/* marconiMet - Internet Radio network 

* Distributed Radio Antenna Server (RAS) : [RAS implementation] 

* S<marconi.ras.>MarconiServer. java -v3 . 0 (prototype version), 1998/12/22 S 

* fljdkl.2, -riK. 
*/ 

package narconi . ra3; 

import java.mi.*; 

import java. rnu. server .*; 

import java . rmi .registry . Locat eRegistry ; 

import ]ava.net.*; 

import java.util.*; 

import java.io.*; 

import marconi .util. *: 

1 * The <code=>MarconiServer</code> clasa implements the interfaces <eod«>RAS</code> 

* (radio antenna server) and <ccde>LAS</cade> (local advertisement server). 

* As a RAS, it should manage a particular set of multicast channels that are 

* active and allow the IRCs (internet radio clients) to be able to tune to 

» each channel. The LAS server provides an API-like interface to the advertising 

* companies. It also maintains a locaL database to store the commercials. 

* <p> 

* Sauthor -riK. 

* Sveraion ^Revision; 1.0 $ 

* Ssee (T.arconi . ras .Channel 

* 8since prototype 1.0 
*/ 

public class MarconiServer extends UnicastRemoteOb ject 

implements RAS, Runnable < // this version does not implement LAS yet... 

/* 

* Radio Antenna Server local id 

final String name = "marconiwet: RAS, the radio antenna server/MarconiServer"; 
final static String obj_nam« - "marconi. ras .MarconiServer"; 
private String hostname - null; 

/** 

* The hard-coded port number for local RMI registry. 
*/ 

public final static int RMI_PORT - 567 8; 

. 1 * The multicast address used for global announcement of CDP packets, 
public final static String GLOBALJCAP - "225.3.0.0"; 

1 * The multicast address used for local announcement of CDP packets. 

public final static String LOCAL_CAP - "225.3.0.1"; 

/" 

* The pott used for channel announcement protocol (CAP) . 
*/ 

public final static int CAP_PORT - 7777{ 

1 * The port used for multicast communication between RSC and RASs . 
*/ 

public final static int RSC_PORT ■ 8910; 
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/** 

* The pore used for multicast communication between RA5 and IRCa. 
*/ 

public final static int IRC_P0RT = 8510? 
/«* 

* The default TCP poet used foe communicating with the RTSPServer. 
*/ 

public final static int RTSP_PORT = 8765; 
/*♦ 

* The ttl used for mjlticast from RSC to 3ASs. 
*/ 

public final static int GLQBAi_TTL = 128; 
/** 

* The ttl used for multicast from ras to IRCa . 
V 

public final static int L0CAL_TTL - 16; 
/** 

* The maximum number of channels that can be supported locally (finite number 

* of channels) . 
*/ 

public final static int max_CKANNELS = 20; 
/** 

* The maximum media content payload length in bytes (=RTP payload length) . 
public final static int MAX_PAYLOADLSN - 4096; 

/*# 

* The maximum RTP header length. 
*/ 

public final static int MAX_RTP HD R1EN - 2 0; 
/** 

* This thread receives channel announcements and maintains the channel 

* directory database (analogous to session directory -Sdr) . 
*/ 

private volatile Thread directoryThread - null; 
/** 

* This thread announces the channel descriptions to the local listeners. 
*/ 

private volatile Thread announcerThread • null; 
/>-* 

* This thread is started along with the <xode>directoryThread</code>. It ia 

* used to generate the advertisement schedule. 
*/ 

private volatile Thread advertiseThread - null; 
/** 

* RAS channel registry / database. 
*/ 

private Channel!] channelRegistry » null; 
/** 

* Station multicast address (CDP) to channel id mapping. 
*/ 

private Hashtable channelMapper - null; 

private final static Integer NONSUPPORTED - new Integer (-1); 
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/" 

* Channel Announcement Protocol Cache. 
'( 

private Hashtable capCache = null; 
/** 

* The RTSESetrver remote controller. 
*/ 

private RTSPServerCcntrol rtspServer = null; 

* The Local multicast address dispenser (one instance per RAS) , 
»/ 

private Maddrni spenser l_maddrRegistry = null; 
/** 

* The local multicast address for local station's content. 
*/ 

private Ir.etAddress l_maddr_local = null; 
/.« 

* The lecal station' s channel id. 

*; 

public final static String LCCALSTA - "LOCAL"; 
/** 

* The files containing local station's program announcsiwnt, 
*/ 

private final static String I0CALSTA_CDP - "_localcdp" r - f , 
private final static String LOCALSTA_SCHED - "^localsctied*? ; . 

'* Time interval between each Marconi process (30 seconds) . 
private. final static long INTERVAL - 10000; // reduced for demo 

* Channel Announcement Protocol (CAP ) resources. 
*/ 

private Multicast Socket eap_receiver - null; 
private Multicast Socket cap_s«nder - null; 
private boolean S0CKBT1_IN_USE =- false; 
private boolean SOCKET 2_IN_USE - false; 

/** 

* The RSA public key. 
*/ 

private byte U publicKey - { (byte) 0x0); 
/** 

* The RSA private key. 

-/ 

private bytet] privateKey - ((byte) 0x0 J; 

'* Instantiate the MarconiServer of RAS (radio antenna server) with its 

* default settings. It also establishes a connection to the RTSPServer. 
V 

public MarconiServer (String rtsp_h, int rtsp_p) throws RemoteException { 
try { 

// initialzie 

hcstname - InetAddxess.getLocalHost () .qet Host dame (I ; 
rtspServer - new RTSPServerControl (rtspji, rtsp_p) f 
channelRegistry - new Channel [MAX_CHANNELS] ; 
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ehannelMap^r = new HaahtableO; 
capcaehe = neH Hasheable 0 ; 
eap_sender - new MulticastSocket 0 7 
cap_ceceiver = new MulticastSocket (CAP_PQR~) ; 
l_maddrRegistry - new MaddrDispenser ( ) ; 
l_maddr_local = l_maddrRegistry . next () ; 

// join CAP multicast group 

cap_receiver. joinGroup (Inet Address . getByName(GLOBAL_CAPJ ) ; 
catch (Exception e) \ 
start ( > ; 

} 

/** 

* Registers a station into a channel slot. These slots are indexed through 

* the channel id' s. 

* Gparam c the channel id. 

* (3param ma global multicast address used for station broadcast. 

* Grtsturn true if the station/channel i3 successfully registered and false 

* otherwise. 
*/ 

public synchronized boolean regiaterChannel (int c, String na) 
throws RemoteExeeption ( 

//if channel is not already taken and its updated each* exists 
if (channelRegistrv lc) ~- null ss capCache.containsKey (ma) > I 

// add new channel to database 
channelMapper.put (ma, new Integer(c)); 
try { 

InetAddress ljnaddr - LmaddrRegistry.next () ; 
channelRsgistry tc] - new Channel (c, l_maddr) ; 

> ' 

catch (MaddrException e) { 
return false; 

\ 

// initialise channel from the cache 

channelRegistry[c] . read_cdp ( (CDPPacket) capCache.get (ma) ] ? 
channelRegistrytc] . init (publicKey, privateKey) ; 

// remove new channel from the global cache 
//capCache . remove (ma) ; 

Sy at em • out . pr i ntln 

(c-bj_name ♦ ".registerChannel: created channel-" + c) ; 

return true; 

\ 

// if channel in use 

else { 

System. err , println (obj_name + 

".register. Channel: cannot create channel-" + c) ; 

return false; 

} 



/** 

* Removes a channel from the database. 

* Gparare c the channel id to be removed. 
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* Sreturn true if the station/channel is successfully 
. otherwise. 

*/ 

public synchronized boolean renoveChannel (int c) 
throws RemoteExeeption [ 
// if the channel exists 
if (channelRegistry [c] != null) < 

fi 3tep the channel thread and free resource 
if (channelRegistry [c) . isOnline () > K 
channelRegistry [c] .destroy 0 ; 

l_maddrRegistry . remove (channel Rag is try t c 1 . l_maddr) ; 

// remove channel from database 

channelMapper .put IchannelRegistry [c] .g_maddr . getHcstAddress () , 

NOT_SUPPORTSD) ; 
channelRegistry [c] = null; 

System. out .println (gbj_name + " . removeChannel : removed channel-" + c) ; 
return true; 

> 

// if the channel doesn't exi3t 

else I 

System. err. println(obj_name + 

". remove. Channel : cannot remove channel-" + c) ; 

re-urn false; 

} 



I* 

* @deprecated replace by RTCP signaling, 

* This class does not actual Ly implement the audio playing mechanism. It 

* Return the status of this request. This method is merely used as means 

* of finding out who's listening to what. The next version should replace 

* this nodule with a more scalable approach such as by utilizing the 

- RTCP signals. Currently, this RMI request is also being used to trigger 

* the actual broadcasting. IE the requested channel is broadcasting 

* already, nothing else ia done. If not, the MareoniServer initiates the 

* broadcasting procedures (i.e. start listening to the global multicast 

* address and redirecting the stream locally! . 
* 

* eparam c the channel id. 

* Greturn true if successful* false otherwise. 

public synchronized boolean playChanneK int c) 
throws RemoteExeeption { 

// it channel exists 

if (channelRegistry [cl !- null) ( 

// if channel not already started, signal RTSPServer to start it 
channelRegistry (cl . HTT_C0UNTt-t-; 
if {! channelRegistry [e] .isOnline O ) < 
try ( 

channelRegistry [c] . start 0 ; 

System. out. println <obj_name + " .playChannel : channel-" + c 
+ " started.") ; 

} 

// catch TooManyChannelThreadsException 
J J & IllegalThreadStateException 
catch (Exception e) { 

System. err .println (obj^name + 
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".playChaonel: _ _ 

return false? 



// return the local multicast address of the channel 
return true; 

> 

else ( 

System. err .println (obj_name + 

".playChannel: cannot play channel-" + c) ; 

return false; 

} 

*J 
/-<■ 

* Stops oil broadcasting channels and terminates this RAS. 
*/ 

public void shutdown () throws RemoteExcept ion { 
synchronized (channelRegistry) ( 

for (int i = 0; i < MAX_CHANNELS ; i++) < 
if (channelRegistry [i] !- null) [ 
reraovsChannel (i) ; 

\ 

) 

i 

stop ( ) ; 

System. exit (0) ; 

) 



/** 

* Starts the MarconiServer. 
*/ 

public void start () i 

directoryThread - new Thread (this) ; 
directoryThread. start ( ) ; 
announcerThread - new Thread (this).; 
announcerThread. start 0 ; 
advertiaeThread - new Thread (this) ; 
advert iseThread. start () ; 



/** 

* Steps the HarconiServe* ■ 
*/ 

public void stopd i 

directoryThread - null; 
announcerThread - null; 
advertiaeThread - null; 



// release sockets and leave announcement group 
try { 

while <S0CKET1_IN_USE> { 
Thread. sleep U> ; 

> 

cap_reeeiver.leaveGroup(InetAddre8s.getByNamelGL0BAI^CAP) ) ; 
cap_receiver. close O 
cap_sender. close <) ; 

) 

catch (Exception e) { 
e . printStackTrace <) ; 

) 

} 
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Returns the channel usage statistics. 

Sreturn an array of channel statistics. The array size is the 

<code>KAX_CHANNELS</code>. There maybe <corie>null<:/eode> entries in the 
array for the channel slots that are not supported. 

'/ 

public ChannelStatistics [] getStatisties () ( 

ChannelStatisticst] stats - new ChannelStatistics [MAX_CHANNELS] ; 
synchronized (channelHegistry) { 

Car (int i = 0; t < MAX_CHANNELS ; i++) { 
if (channelRegistey [il !- null) ( 

statsU] = channelRegistry (il .auditi) F 

) 

} 

} 

return stats; 

) 

/** 

* Adds commercial list. 

* eparam ad_list an array of <ccde>String</code>3 that refers to the 

* commercial filenames. 

* @ return whether the request was successful. 
*/ 

public boolean submitComirercialList (String [] ad_list) ( 

try I , • 

fcr (int i = 0; i < ad_list . length; 1+4) { , ; 

StringTokenizer st = new StringTokeniier <ad_list [ i] ) ; 
int id - Integer. parselnt (at. nextloken ()) ; 
channelFegi3try [id] .addCommercial (st.nextToken O ) ; 

> 

for (int i = 0; i < MAX—CHANNELS; i++) ( 
if (channel Registry [i] I- null) { 

channelRegistry [ij .genCommerciaiFile () ? 

) 

> 

return true; 

> 

catch (Exception e) < 

System, err .println (ob j_name + 

".submitCcnrnercialList : illegal list format") ; 

return false; 

} 

\ 

/* 

* This <code>run</eode> method starta the Marconi Server . 
*/ 

public void run() ( 

// cache update hour 

long hour - System. currentTimeMillis O ; 
/* 

* Global directory thread running. 
*/ 

while (Thread. currentThreadO — director/Thread) { 
/* 

* Receive CDP packets and maintain channel database. 
*f 
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SOCKET 1_In_use - true; 
try ( 

□ atagrartiPacket recv_jj)ct = CDPPacket . compose O ; 
cap_recei ver . receive I recvjskt) ; 
CDPPacket cdp = new CDP Packet (recv_pkt I ; 

synchronised (channelRegistry) ( 

// create new mapping 

if ( IchannelMapper.containsKey {cdp.MADDR) ) { 

channelMapper.put (cdp.MADDR, NOT_S UP PORTED) ; 

} 

// update announcement appropriately 
Integer Id = (Integer) cnannelMapper-get (cdp.MADDR) ; 
if ( Id- equals (NONSUPPORTED) > { 
capcache. put (cdp.MADDR, cdp); 
System. out. println (obj_name +■ ".run: new cdp cached for " + cdp.MADDR); 
} 

else { 

channelRegistry [Id.intValue O ] . read^cdp (cdp) ; 
3yste.n.out.printlnlobj_name +■ ".run: local channel's cdp cache refreshed"); 
} 

} 

) 

catch (Exception e) { 

e,printStackTsace() ; 

> 

S0CKET1_IH_U3B - false; 

// time to ceEieali cache (daily) 
long current_hour = System. currentTimeMillis () ; 
if (current_hour > hour + Timestamp.DAY) { 
System. out .println (ob j_name + ".run: routine -refresh local cache"); 

refresh_cacne() ; 

hour 4— Tiraeatamp.DAY; 

■ i 
/* 

* Interval b/w each loop for receiving global channel directory. 

V 

if (! Thread. interrupted (> ) I 
try < 

System, out. println (obj_name 4- ".run; - "); 

Thread .sleep ( INTERVAL) ; 

> 

catch (InterruptedExeeption e) { 

. > 

} 

/* 

* Local Directory thread running. 
*/ 

while (Thread. currentThread O -« announeerThread) { 
/* 

* For each installed local channel send out announcements. 
*/ 

for (int i » 0; i < HAX_CHAHNELS fis announcer Thread 1- null; ( 
if (channelRegistry[i] =— null) { 
continue; 

> 
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CDPPacket cdp - channelRegistry [il .writ 

Datagram acket 7end_pkt - local_cdp .compose [LOCA1-CAP, CAF_PORTN 
' cap_sender. sen d(send_p)<.t, (byte) LOCAL_TTL) ; 

catch (lOException e) { 

Sy3tem. out. print In <obj_name + ".run: 
e.printStackTraceO ; 

) 

// sleep between every announcement (do not flood network] 

try 1 

Thread. sleep (50 00) ; 

catch ( inter ruptedException e) { 
> 

) 

/* 

* Announce local tract programming. 
*/ 

if (announcerThread != null) ( 

cap_sender.sendlsend_.pkt, (byte) LOCA__TTL) ; 

\ 

catch (Exception e) ( m 

System. out. print In (obj_jiame + ".run: ); t * 
e.printStackTraceO ; 

) 
\ 

'* Interval b/w each loop for aending local channel directory. 

if (! Thread. interruptedO > { 
try { 

Thread. sleep (INTERVAL) ; 

catch (InterruptedException e) I 
} 

) 



Advertise thread running- 



while (Thread. cur rentThreadO advert i a eThread) { 

i'nump each channel' s commercial queue (list of conunercials to play) 
. to a m« so that it can be u«d by the LMP (local advertent 
* insertion protocol) . 

far <int i - 0; i < MRX-CHAHNELS ; H-+) ( 
if (channelRegistry[i] !- null) { 

channelRegistry [ij .genCommercialFLle 0 ; 

} 

** Interval b/w each loop for generating commercial files. 
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if (! Thread, interrupted O ) ( 
try { 

Thread. s Leep {Timsatamp . DAY / 4); 

) 

catch (InterruptedException e) { 
> 

\ 

I /Thread. yield 0 ; 

) 

} 

/*' 

• Removes old cache entries. 
*/ 

private void cef reah_cache ( ) { 

long current_hour » System. currentTimeMillia 0 ; 

synchronized (capCache) { 

Enumeration capCist = capCache , elements 0 ; 
while (capList .haaMoreElements 0 ) { 

CDPPagket cdp = iCDPPacket) capLiat . nextElernent < ) ; 
if (current_hour > cdp - time Stamp + CDPFacket . TTL) { 
capCache. remove (cdp .MAD DR) ; 

) 

\ 



/** , ' 

* Provides lccal and global cache of channel announcements for f : 

* immediate download (instead of waiting Car the periodic announcement) . 

* Gparam local <code>true</code> if requesting for a local announcement download. 

* Greturn list of channel descriptions (CDPPackets) in <code>Vector</code> . 

* Gsee marconi.util. CDP Packet 
*/ 

public vector flownloadCSP (boolean local) throws RemoteExcepticn I 

!/ return local announcements 
if (Local) { 

synchronized (cnannelRagistry) { 

Vector cdp_liat - new Vector ( I, - 

for <int i - 0; i < MftX_CHANWEL5 ; i++) ( 
if {charnelRegistry [i] !■» null) ( 

CDPEacket cdp - channelRegistry li] -write_cdp(> ; 
cdp_list .addElement (cdp) ; 

} 

) 

return cdp_liat; 

} 

> 

// return global announcements 
else { 

synchronized (capCache) { 

Vector vec - new Vector (I; 

Enumeration ertum - capCache . elements 0 ; 

while (enum.hasMoreElements <> ) ( 

vec. adcE lenient (enum. next Element O J ; 

} 

return vec; 

) 

> 
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/ * Creates a COP announcement for the Local station track;. 

* <>return a channel description of the local track. 

• @see n.arconi.util. CDPPacket 

private CDPPacket write_cdp|) throws AnnouncementException ( 
CDPPacket cdp - null; 
BuffereaReader fin = null; 
String schedule = ""; 

cdp - new COPPacket !LOCAL5TA_CDP) ; 

fin = new Buff eredReader (new FileReader ( LOCAL STA_SCH£D) ) ; 

I 

catch (Exception e) { 

throw new AnnouncementException 

<obj_name + " .write_cdp : the local schedule file cannot be opened. >; 

\ 

while (fin !=■ null) { 
String line = null; 
tty ( 

if ((line - f in. readLine O } — null) { 
fin. close!) ; 
break? 

> 

catch (lOException e) { »* 
break; f! 

1 

if (line. length () > 0) { 
String program ■ ""; 

StringTokenizer st = new StringTokenizer < Line) ; 
Calendar cal - Calendar .getlnstance () ; 

try \ 

for (int i - 0; i < 2; i++) ( 

cal .set (Calendar . DAY_OF_WEEK, Integer .paraelnt (st . nextToken 0) ) ; 
cal. set (Calendar. HOUR_OF_DAY, Integer. parselnt Ot.nextTokenO ) ) t 
cal. set (Calendar. MINUTE, Integer. paraelnt (st . nextToken < ) ) I ; 
cal. set (Calendar. SECOND, Integer .paraelnt (at .nextToken ( ) ) >; 
program 4- String. vaLueOf (cal.getTimeO .getTimeO ) + "I"; 

> 

program st .nextTofcen ( ) + 

schedule [ schedule. length ( ) > 0) + program; 

1 

catch (Exception e> ( 

throw new Announcement Except ion 

(obj_name + •.write_cdp: invalid local schedule file. ); 

} 

\ 

> 

cdp. id - LOCALSTAr 

cdp . date =■ Timeatamp . g«t_midnight ( ) ; 

cdp.MADDR » this.l_piaddr_Jlocal.getHo3tAddre33() f 

cdp.MEORT - this.IRC_PORTf 

cdp.MTTL - this.LOCAL_.TTL; 

cdp. schedule - schedule; 

return cdp; 

\ 

/* 
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* The main method executes the server setup proce 

public static void main (St ring argsU) throws RemoteException ( 

it check arguments <rtsp server) 
if (args. length !- 2) { 

System. arr.printlnCusage: \n" 

t "MarconiServer <RTSP hostname> <RTSP port>") ; 

System. exit (-1) ; 

\ 

System. setErr (System. out) ; 

// install a security manager 

System. setSecurityManager (new RMISecurityManager ()) ; 

'/ setup and start the server on local host 
try < 

LocateRegistry.createRegLstry (RMI_?CRT) ; 

MarconiServer ntarcontServer = new MarconiServer {args [0] , 

Integer. parse Int (args [1] ) ) ; 
Naming. rebindC/7: " + RMI_FORT + ■/" + obj_name, marconiServer) ; 
System. out . print In (mar coniServer . hostname 

+ " bound in registry at port " + RMI_PORT) ? 

} 

catch (Exception e) ( 

System. err. println (ob j_name + ".main: " t e .get Message O ) ; 
e.printStackTraceO ; 

} 

t >' 
t f : 
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/* marconiNet - Internet Radio Network 

* Distributed F*dio Antenna Satvar (RAS) : [IRC GUI Controls] 

* 5<marconi. ire. >IRCControls. java -v2.0 (prototype version), 1999/02/15 S 

* ejUJtl.2, -riK. 
V 

package marconi.irc; 

import java.awt.*; 
import jave ,awt .event .* ; 
import java.util.*? 
import java.net.*; 
import java.io.*; 

/** 

* This panel contains user interfaces to the applet. 
V 

public class IRCControls extends Panel ( 
public static Text Fie Id entry_l; 
private static int WIDTH = 600; 
private static int HEIGHT - ICO; 

/** 

* instantiates the control panel. 
*/ 

public IRCControls 0 i 

GridBaqLayaut grid = new GridBagLayout < I ,* 
GridBagConstrainta cons - new GridBagConstraints < ) ; 

setLayout (grid) ; '* 
eon 3- fill - GridBagConatraint3.NONE; ! ; 

cons. weight* - 0.0; 

// selected station (id + name) 

entry_i - new TextField (40 ) ; 

grid.setConatrainta (entry_l, cons> ; 

ertry_l. setForeground (Color, yellow. darker () > ; 

entry_l. setBaekground (Color. blue .darker 0 .darker ( ) ) ; 

add(entey_l) ; 

validate 0 ; 



// resize 

setSize (WIDTH, HEIGHT); 
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/* marconiNet - Internet Radio Network: 

* Distributed Radio Antenna Server IRAS) : [IRC Directory Controls! 

* S<marconi'.t-as.>IRCDirectory. java -v2 . 0 (prototype version), 1999/Q4/2Q ? 

* ejdlcl.2, -riK. 



import java.utiL.Hashtable; 
import java.net.*; 
import java.io . *; 

import margoni . tas .MarconiServer; 
import marconi , util . CDPFacket; 

/" 

* This panel contains uacc intetfacea to the applet. 
•/ 

public class iRCDirectory extends Panel 
implements Runnable ( 

! * Thi3 thread updates the announcements for the locally supported channels. 



private Thread updateThread - null; 
private static long L_UPDATE - 7500; 

public static iRCUsrApplet owner; 
public static Label latael^l; 
public static List direct© cyList_l; 
private static int WIDTH - 600? 
private static int HEIGHT - 400; 

/" 

* Instantiates the directory display panel. 
V 

public IRCDirectory (IRCUsrApplet main) ( 
owner = main; 

GridBagLayout grid - new GridBagLayout O ; 
GridBagConstxaints cons - new GridBagConstrainta () ; 
setlayout (grid) ; 

cons, fill » GridBagConatraints.NONE; 
cons.waightx - 1.0; 

// label 1 

cons . weight* - 1.0; 

cons .gridwidth - GridBagConatraints. REMAINDER; 
label_l - new Lab«l () ; 

label_l.setText< "Lpcal Channel Directory"); 
grid.setconatrainta (labal_l, cons) ; 
lab«l_l . setForeground( Co lor .white) ; 
add(Label_l); 
validate () ; 

// list 1 - global 

cons. gridwidth - GridBaqConstraints .REMAINDER; 
directoryList_l - new List {20, false); 

di r ect o ry Li s t_l . addAct i o nli at ener ( iRCAct ionHandler .listContral); 

grid. setConstraints (directoryLiat_l, cona) ; 

direct oryList_l .set Foreground (Color .yellow .brighter I ) ) ; 

di r act or yLi s t_l . set Background ( Col or . darkGr ay ) ; 

add(directoryList_l> ; 

validate*); 



*/ 

package marconi . ire; 



import ]ava.awt.*; 
import java. awt .event . *; 
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// resize 

aetSiaa (WIDTH, HEIGHT); 
start < ) J 

/** 

* Starts the directory update. 
*/ 

public void start () { 

updateThread = new Thread (this) ; 
updoteThread. start 0 ; 

) 

/*' 

* The run methods for the two threads. 
*/ 

public void run() { 

// local directory 

nhile (Thread. current Thread!) -= updateThreadl ( 
try { 

Thread. sleep (L_UPDATE> ; 

Haahtable cdp_lookup => owner .getCache 0 ; 

if (directcryLiat_l . getltemCount (I > 0) i 
directory List_l .removeAll () f 

} 

for (int i - 0; i < owner. MAX_CHANNELS; i+H I 

String Id = String. valueOf <i) ; f r 

if (cdp_lookup.cantainsKey (Idl) ( 

CDEPacket cdp - (CDPPacket) cdp_lookup . get (Id) ; 
directoryList_l .add (cdp. id * " " + cdp .name. 

Integer. parsalnt (cdp. id) ) ; 

) 

else { 

directory Li st_l . add ( Id> ; 

i 

) 

if (cdp_lockup.contairsKey (MarconiServ«r.LOCALSTA) ) { 

CDPPacket cdp - (CDPPacket) cdp_lookup.g«t (Marconi5«rvar.LOCAl.STA> ; 
directoryLiat_l.add(cdp.namel ; 

\ 

\ 

catch (Exception e) { 

System. *rr .print In < "marconi . ire . iRCDirectory . run : ') ; 
e .print StackTrace I ) ; 

} 

} 

) 

} 
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/* marconiNet - Internet KsWa Network 

* Distributed Radio Antenna Server (RAS) : [IRC Usee Applet! 

* Vraarconi.irc.^PCUsrApplet. i^va -v2 . 0 (prototype version! , 1999/04/20 5 

* 0jdkl.2, -riK. 
*/ 

package marconi. . ire; 

import java. applet. *; 

import java.awt.*; 

import java.util. *; 

impart java.net.*; 

//import java.rmi."; 

//import java. rmi , server . *; 

import marconi.util. *; 

import marconi.util. rtsp. IRC; 

import marconi.ras.RAS,' 

import marconi .ra3. MarconiServer; 

/** 

* This applet is used by an IRC user. 

* @author -riK. 

* (aversion SRevision: 1.0 5 

* Ssee narconi . ras .MarconiServer 

* aaince prototype vl.O 
*/ 

public class IRCUsrApplet extends Applet 

implements java . io . Serializable, Runnable { t » 

/** * 

* Session Announcement Protocol (SAP) resources. 

* Interfaced via. Channel Directory/Description Protocol <CDF) . 
*/ 

private MulticastSocket cap_receiver - null) 
protected Kashtable capCache = null; 

This thread updates the announcements for the locally supported channels. 

V 

private Thread directoryThread - null; 
private static long L_UFDA7E - 10000; 

// miseellaneious variables 
private atatic int width - 0; 
private atatic int height - 0; 
//protected RAS rasServer - null; 
protected int HAX-CHANNELS - 20; 

final static String obj_narae - "marconi. ras. IRCUsrApplet"; 



// tools 

IRCDi rectory directory - null; 
IRCControls controls - null; 
IRC listener - null; 



/** 

* initialise the applet and setup display area. 
*/ 

public void init () ( 
try { 

width = Integer . parse Int (getParameter ("APPLMIDTH") ) ; 
height - Integer. parsernt (getPararaeter ("APPLHEIGHT") ) / 

// lookup RAS (MarconiServer) 
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//BSL URLbase - getDccumentBase () ; 

//System. out. println(obj_name ■(- ".init: locating server*]; 
//raaServer <■ [rrs> Kami iiq . lookup [•// " 1- uatFarameter ( "FtASHoat " ) 



// init variabUs 

//KAX_CHANNELS - raaServer .getMaxChannels ( ) ; 
capCache - new HashtableO; 



catch (Exception e) { 
// fatal error 

System. err. println (ob j_name + ".init; "); 
e.printStackTtaceO ; 



// join CAP multicast group 
try { 

cap_receiver - new MulticaatSocket (MarconiServer .CAP_J>0RT) ; 
cap_receiver . joinGroup I Inet Address . get ByName (Marconi Server . LOCAL_CAP| ) ; 



catch (Exception s) ^ 

System. out. print in {obj_name +■ ".init:"); 
e.printstaekrraee () ,* 



I / draw display area 
setupDisplay () ; 

// start 

listener - new IRCO ; 
directoryThread » new Thread (this> ; 
directoryThread . start ( ) ; 



/** 

* Display the applet. 
*/ 

pubLic void setupDi splay () ( 

setBackground (Color .black) ; 

directory - new IRCDirectory (this) ; 
controls - new IRCControls ( > ; 
GridBagLayout grid « new GridBagLayOut ( ) ; 
GridBagConatraints cons - new GridBagConstrainta O ; 

// setup grid 

int rovHeightsU - {400, 100}; 
grid.rowHeighta - rowHeighta; 
setLayout (grid) ; 

cona.fill - GridBagConstraints . BOTH; 
// add directory lists 

cons. grid* idth - GridBagConatraint 3. REMAINDER; 
cons .weight* » 1.0; 
cons.gridhaight - 1; 

grid. setConatraints (directory, cona ) ; 
add(directory) ; 
validate ( ) f 

// add controls 

cons.gridwidth - GridBagConstraints. REMAINDER; 
cona.weightx - 1.0; 
cons.gridhaight ■ If 



// 
// 



+ -;" + getParameter ("RASPort" ) 
+■ "/marconi . raa.MarconiServer" ) ; 



} 
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grid.aetCori3trai.nts (controls, cons) ; 
add (controls) ; 
validate () ; 

re a i. ze ( width , he ight ) ; 

> 

• Free resources when closing applet. 

public void destroy (I { 

// release sockets and leave announcement group 
try { 

gap^receiver - 1 eaveGroup ( Inet Addregs . getSyName (MarconiServar . L0CAL_CAP) ) ; 
cap_recaiver . close ( ) ; 

) 

catch (Exception e) 1 

e . printStackTrace ( I ; 

> 

stopChannel ( ) ; 

direct sryTtiread - null; 

//try { 

// ras Serve r . terminate () ; 

//} 

//catch (RemoteException e) ( 
// e. printStackTrace <) ; 

il\ 

remove (directory) ; , ; 

remove (controls) ; 

\ 

/** 

* Run method. 
*/ 

public void run() ( 

// cache update hour 

long hour = System. currentTimeMillis <) ; 
/* 

* Global directory thread running. 
*/ 

while (Thread. currentThread() — directoryThread) { 
f* 

<• Receive CDP packets and maintain channel database. 
V 

try { 

DatagramPacket recv_pltt - CDEPacket. compose {) ; 
cap_ receiver, receive <recv_pkt ) ; 

CDPPacket cdp - new CDPPacket { recv_pkt ) ; 

System, out .println (obj_name + ".run: cdp parsed'); 

// update announcement appropriately 
if ( icapCache.containsKey (cdp. id) ) \ 
capCache.put (cdp.id, cdp); 

System. out. println (obj_name + ".run: new cdp cached for channel-" 
+ cdp.id) ; 

\ 

> 

catch (Exception e) { 



132 



WO 00/79734 



PCT/LS00/I6913 



IROJarApplrt . £ I-m Jun 17 14:28:50 1999 

e - printStackTrace { ) ; 

) 

// time to refresh cache (daily) 

long current_hour = System. currentTimeMillia 0 ; 

if (currentjiour > hour + Timestamp . DAY) { 

System. out . print In ( ob ] name + ".run: routine -ref reshing directory cache. '); 

refresh^cache <) ; 

hour +» Timeatarap.DA^; 

) 

/* 

* Interval h/w each loop for receiving local channel directory. 
*/ 

try ( 

Thread. sleep (L_UPDATE) ; 

I 

catch ( InterruptedException e) I 
) 

) 

\ 

!<■<■ 

' Renovea old cache entries. 
*/ 

protected void rerresh_cache O { 

long current_hour = System. currentTLmeMillia () ; 

synchronized (capCache) ( , ♦ 

Enumeration capList = capCache . elements 0 ; 
while (captist .hasMoreElements O ) [ 

CDPPacket cdp =• (CDPPacket) capList .nextElement ( ) f 
if (current_hour > cdp.timeStamp +■ CDPPacket . TTL) { 
capCache . remove (cdp. id) ; 

> 

} 

1 

) 

/** 

* inform server that the specified channel is being listen to. This 

* RMI baaed triggering is very inefficient and not scalable. So 

* alternate approach based on RTCP should replace this. 
V 

public boolean playCharuiel (int id) { 
boolean status - false; 

if (capCache. containsKey (String. valueOf (id) ( ) ( 

CDPPacket cdp - (CDPPacket) capCache .get (String. valueOf (id) ) ; 
try < 

// Jeill previous thread if running 

listener . stop ( ) ; 

/* 

* The below statement is commented out because the listener 

* is now capable of sending RTCP signal* for triggering. 

status - rasServer .playCharinel (id) i 
*/ 

status - true? // replace above 

1 ist ener . st ar t < cdp . MADDR, cdp.MPORT) f 

) 

catch (Exception e) ( 
e . printStackTrace ( ) ; 
return false; 
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return status; 

} 

else I 

return false; 

\ 

J 

/** 

' stops listening to whatever is playing. 
V 

public void stopChannem i 
listener. stop {) ; 

I 

1 * Returns the current state of the local channel announcement cache. 
V 

protected synchronized Haahtable getCache O ( 
return capCache; 

\ 

/** 

* Return applet information. 
*/ 

public String getAppletlnf o O ( 
roturn "irc listener tool"; 
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/* narconiNrt - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) ; [IRC Action Handler] 

* $<marconi.irc.?IRCActionH»ndler. java -v2 . 0 (prototype version!, 1999/04/21 5 

* GjdJcl.2, -riK. 
V 

package marconi.irc; 

import java.awc.*; 
import java. awt. event . *; 
import java.util . *; 
import nava.io.*; 

/** 

* Thia class handles actions taken by IRC user. 
V 

public class iRCActionHandler { 

public static ActionListener ListCantrol = new ActicnListener ( ) { 
public void actionPerformed (ActionEvent e) { 
IRCControls . entry_l . 3etText 

[ iRCDi rectory .direct oryList_l. get I tern 
(lRCDire.ctory.directoryLiat_l.getSele.ctedIndexO ) I i 
String tQXtfield = IRCControls ,entry_l.getrext () ; 
StringTokeniier dir = new StringTokeniier (textf ield, " ") ; 
int id - Integer . parselnt (dir .nextToken () ) ; 
iE (iRCDireccory.owner.playChannel(id) > i 

System. out .print In ("marconi . ire . :RCACtionHandler" + 

".actionPerformed: playing channel " 

+ id + "."); . f 

} ! : 

else ( 

IRCDirectory. owner .stopChann*l I ) ; 

System. err .println ( •marconi . ire . IRCActionHandler " + 

•.actionPerformed: error listening."); 

\ 
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* Distributed Radio Antenna Server (HAS) : [CDE> Announcer] 

* S<mareoni.ras- >Announcer • java -v2 . 0 (prototype version), 1999/04/12 $ 

* 9jdkl.2, -riK. 
*' 

package marconi. rsc; 

import java.net.*; 
import java . ut il. * ; 
import java. io . ■; 

import marconi . cas . MarconiServer; 
import marconi , util . *; 

1 * The <code>Announcet</code> makes periodic announcements via. CDP (SAP/SDP) . 

* <p:> 

* Uauthor ~riK. 

* @version SRevision: 1.0 $ 

* @see marconi. util. CDPPacket 

* (Baince prototype 1.0 
*/ 

public class Announcer implements Runnable { 

final static String obj_name = "marconi . rac .Announcer" ; 
String hostname - ""; 

' 1 * This thread announces the channel descriptions to the local listeners. 

*/ * * 

private volatile Thread anncuncerThread - null; 

* Time in-erval between each Marconi process (30 seconds* . 
*/ 

private final static long INTERVAL =• 30000; 
/** 

* Channel Announcement Protocol (CAP) resources. 
*/ 

private MulticastSocket cap_sender - null; 

private String file - ""; 

/** 

» Constructor- 
V 

public Announcer (String file! { 

try { 

hostname - Xnet Address. get LocalHost I ) .getHostNarae () ; 
cap_sender - new MulticastSocket < ) ; 

\ 

catch (Exception •) { 

} 

this. file = file; 
start () i 

} 

/** 

* Starts the Announcer. 
*/ 

public void start () ( 

annour.cerThread - new Thread (this) ; 
arnouricerThread. start ( ) f 
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/** 

* Stops the Announcer. 

V 

public void stopO ( 

arinouncerThread - null; 

// release sockets and leave announcement group 
try < 

sap_sender . elossO ; 

} 

catch (Exception e) < 

8 . printStacltlraca ( ) ; 

> 

t 

/♦* 

* This <code>run<:/eode> method starts the Announcer. 
*/ 

public void run() ( 
/* 

* Announcer thread running. 
*/ 

while (Thread. curre.-iflhreadO =- announcerThread) { 
I* 

* Send out each announcement . 

*/ t* 
CDPPacXet cdp « null; , i 

try < 

cdp = new CDPPacJtet (file) ; 

\ 

catch (AnnouncementExeeption e) { 
e.printStackTrace () i 

) 

DatagramPacket send_pk.t = cdp. compose (Marconi5erver.GL0BAL_CAP, 

Marconi Server. CAP_PORD ; 

if (cdp. id != null) { 
try ( 

cap_aender.aend(send_pkt, (byte) MarconiServer. GLOBAl_JTTL) ; 

} 

catch (IOE.xception e) ( 

System. nut. println <obj_narae + ".run; "I; 
e . printStaekTrace ( ) ; 

) 

System. out. println (obj_nane + ".run; announcement sent to " 
+ MarconiServer.GLOBAlu.CAP + "/" 
+ MsrconiServer .CAPJPORT) j 

I 

/* 

* Interval b/v each loop for sanding local channel directory. 
*/ 

try { 

Thread. a leap ( INTERVAL) ; 

} 

catch ( Inter mptedExcept ion e) { 

\ 

} 

) 
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* The ma in metn0d executes the server setup process . 

public static void main (St ring args [] ) \ 
// check: arguments (ctsp server) 
if (args. length !- 1) { 

System. err. println ('usage ; \n" + "Announcer <CDP file* ); 

System. exit (1) ; 

> 

System. setErr (System. out); 

// Serup and start the server on local host 
Announcer announcer = new Announcer (args [C ]) ; 

) 
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* Distributed Radio Antenna Server (RAS) : [RSC Interface] 



1 



* $<mareoni.ras.>RSC. java - v 2 . 0 (prototype version), 1999/05/14 S 

* ejdkl.2, -riK- 



package mareoni.rac; 



import java. rmi. *; 



import java. util. Vector; 

* The <code>^SC</code> km I interface provides aecurity/payritent APIs for RAS. 

* <p> 

* Sauthor -ciK. 

* aversion SSevision: 1.0 $ 

* Ssinca prototype vl . 0 
*/ 

public interface RSC extends Remote ( 

' * Accept RAS' public key and include this RAS for SEK distribution. 
* SenroLUbytaM publicKey) S 
V 

public int enroll {byte ( ] pubkey) 
throws RemoteException,- 
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/* raarconi.Net " Internet Radio Network 
« Distributed Radio Antenna Server (RAS) = [Channel Descriptions Ciasa| 

* $<marcom.i:a3.>CDPPacket. java -v4 . 0 (prototype version), 1999/05/05 S 

* Gjdkl.2, -riK. 
*/ 

package mareoni . util ; 

import java.io.*? 

import java - net . *; 

import java . util . StringTakenizer ; 

import mareoni .util . sd- * ; 

/** 

* This class encapsulates and parses the Channel Description Protocol (CDP) 

* Packet. It acts as a.T transparent interface to the SAP/SDP protocol (the 

* utilization of protocols SAP/5DP is hidden from the users of COP) . 
» <p> 

* Included in the packet are a subset of the fol Lowing field3 in any order; 

* <ul> 

* <li>name 

* <li>category 

* <li>description 

* <li>origin 

* <li>language 

* <ii>id 

* <li>maddr 

* <li>mport 

* <li.>nittl 

* <li>sekli3t 

* <li>date* 

* <li>schedule* 

* </ul> 

* <p> 

* The channel description can be created from a file or any other object that 

* can be converted to a text stream. The format is given below. 

* <p> 

* Each field is to be contained in a line. Each line is to start with the field 

* name folLowed by '=', and then the field value (i.e. "category-news"). 

* <p> 

* The fields marked * are optional if the CDP packet is not being used to announce 

* program schedules, rf the CDP packet is used for program schedule announcement, 

* all the fields must be specified. (Note: the current version only allows one-day 

* scheduling per an announcement. Multiple CDP packets should be used to schedule 

* for different dates) There ia no version number, nor is there a session id. A new 

* announcement can simply replace the previously received ones. The different 

* announcements are distinguished by examining the multicast address and the date. 

* If one wishes to schedule ahead of time, the date field should be used to indicate 

* to which date the schedule field is assigned. 

* <p> 

* The <code>schedule</code> field should be in the following format: 

* <pxblocfcquote><pre> 

* schedule»Slt;programlsgt; , slt;program2> , slt;program34gt; , . . .etc. 

* </pre></blockquote> 

* <p> 

* separating each sub-field with a comma C'l. 

* <p> 

* The <code>date</code> field ia represented by specifying the number of 

* milliseconds since the standard base time known as "the epoch", namely 

* January 1, 1970, 00:00:00 GMT. GMT (Greenwich Mean Time) is the Internet 

* conventional reference time sone and it is synchronized with the UTC 

* (Coordinated Universal Time) milliseconds. The receivers of this packet can 

* convert this to the appropriate local time. The data type long (64-bit integer 

* in Java) stores these milliseconds. Note that SDP uses the Network. Time Protocol 
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* (NTP) timestamps and SDP essentially conwects UTC t_ . 

* <p> 

* Each program is constructed as : 

* <pxbloclcquote><pre> 

» 41t; start-timeigt; 14 It; end-time 4gt; | sltfprogram-titletgt; I Slt;de3criptionSgt 

* </pre></blockquote> 

* <p> 

1 separating each sub-field with a vertical line CI'). Again, UTC milliseconds 

* should be used to specify the times. 

* <P> 

* Lastly, the seklist is the concatenated list of the radio station' s session 

- encryption Key (SEK), each time encrypted with the public key that belongs to 

* different RASs (if global announcement) or iRCs (if local announcement) . The 

* encrypted values in binary are PEM-encoded and the delimiter ' I ' is u3ed to 

* separate them. Currently CDPPacket is implemented to support RC4 stream cipher; 

* it is a symmetric encryption algorithm with variable key size and fast performance 

* in software. Another nice feature about it is that it is fairly exportable from US, 

* which is necessary for global uaage of MaroniNet . 

* <p> 

* It is necessary that all fields be included (except for the optional cues) , although 

* it is not required to have them in order. 

* <P> 

* Sauthor ~riK. 

* aversion ^Revision: 1.0 S 

* flsee marconi.util . AnnouncementException 

* 8 see marconi . util . Tiniestamp 

* Gaince prototype vl . 0 

*/ * ' 

public class CDPPacket implements Serializable ^ 

final static String obj_name ■ "marconi. raa .CDPPacket"; 

/" 

* The station name. 
*/ 

public String name - null; 
/** 

* The content category ( music j news I sports 1 . . . t . 
•/ 

public String category - null; 
/** 

* The content description. 
*/ 

public String description - null; 
/** 

* The origin of the content (regional IO> . 
*/ 

public String origin - null; 
/** 

* The language of choice. 

*/ 

public String language - null; 
/** 

* The multicast address. 
*/ 

public String MftDDR - null; 
/** 

* The multicast port. 
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public i-nt rt?ORT - 8889; 

* The multicast ttl (set to local scope by default). 
V 

public int MTTL =■ 16; 
/** 

* The array of PEM-encoded (baaefil) session encryption keys. 
*/ 

public String I ] SEKLIST = null; 
/** 

* The channel id. Must be the local hostname if used for global 

* announcement. 
•/ 

public String id = null; 
/** 

* The date being scheduled. 
V 

public long date - -1; 
/** 

* The radio station's content schedule (list of programs) 
V 

public String schedule - nuLl; 
/** 

* The date and time of the packet created. 
V 

public long timeStarap - -1; 
A" 

* The life time of CDP packets (expiration time) . 
*/ 

public final static long TTL - Timestainp . DAK; 
/** 

* The maximum CDP packet buffer, length (currently 4K bytes) . 
*/ 

public final static int MAX^BUFLEN - 40 96; 
/" 

* Raw data containing, the byte-array representation of the packet* if it has 

* one. 
*/ 

private byte [] data ■ null; 
/-* 

* Create3 an empty CDP packet. 
*/ 

public CDPPacJcetl) { 

this .timeStamp - Time stamp. get_cur rent () ; 

> 

* Creates CDP packet from a (received) datagram. 

* Gparam packet the datagram packet that contains COP. 

public CDPFacket (DatagraraPacket packet) throws AnnouncementExceptie-n { 
parss (packet ) ; 
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this .time St amp » t imest amp . get^cur rent <) ; 

} 

/** 

* Creates a CDP packet from a file. 

* Gparam file pathname to where the CDP-file is located. 

public "DFPacket (String file) throws AnnouncementException ( 
parse <fil«>; 

this .timeStamp - Timestamp . get_current ( ) ; 

} 

/*" 

* Initializes this CDP packet by parsing a datagram (UDP) packet. 

* gparara packet a datagram packet. 
*/ 

public void parse (DatagramPacket packet) throws AnnouncementException ( 

!! get session description 
SAPPacket sap - null; 
SDPPacket sdp = null; 
try { 

sap = new SAPPacket (packet .getData ()) ; 
sdp = new SDPPacket (sap.payload) ; 

) 

catch (Malf ormedSDException e) I 

throw new AnnouncementException 

(obj_name + ".parse: the received announcement cannot be parsed. "Ij 

> 

this. name - sdp. name; 

this .description - sdp. info; 

for (int i = 0; i < s dp. at tribute. length; [ 
String attr - adp. attribute (i) ; 
if (attr — null) { 
continue; 

\ 

if (attr.startaHith Clang: ") ) { 

this, language - attr. substring(attr .indexOf (':' ) + U.triraOf 

^ 

else if (attr. startswith ("cat:")) ( 

this, category - attr . substring (attr . indexOf ('!' ) +■ l).trim(); 

\ 

else if (attr.start3With("X-orig: ") ) { 

this. origin - attr. substring (attr. indexOf (' :' ) + D.triraO; 

else if (attr.startswithrx-seklist:") ) ( 
Vector2 seklist - new Vector2(); 
StringTokeniser at - new StringTokeniier 

(attr. substring (attr. indexOf (' : ') + 1 ) - trim ( ) , " I") ; 
while Ist.hasKoreTokenaO) { 

seklist . addElement (at . nextToken O . trim (!) ; 

} 

this. SEKLIST - seklist . toStringArray ( ) ; 

> 

else if (attr.atartsWithCX-date:") ) i 

String date_str - attr. substring (attr. indexOf (' :' ) + l).trim(); 
this. date • Long.parseLong (data_str) ; 

) 

ela* if (attr.startsWithCX-sched:") } i 

this. schedule - attr. substring (attr. indexOf (':' » + D.trimO; 

> 
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^ 

this.MAD CR = sdp. connection. address; 
ttiia.MTTL = rnteqar .par9elnt (sdp. connection. ttl) ; 
chis.MPOBT = Integer. parselnt (sdp. :nedia[0] .getPort [)> ; 
this. id = sdp. origin. segaion_id? 



* Initializes this CDP packet by parsing from a file. 

* Sparam file_path name and path of the CDP announcement file, 
public void parse (String file_path) throws ftr.nouncementException { 

/* 

* Open file. 
V 

File file = new File (file_path) ; 
Buffer-dReader file_in - nail; 

try { 

fLle_in - new Buff eredReoder (new FileReader < f ile H ; 

> 

catch (FileNotFoundException e) I 
throw new AnnouncementExeeption 

(obj_name + ".parse: the CDP file cannot be opened."); 

) 

/* 

* Read-in the file line by line. 
'/ 

while <fiLe_in !=■ null) { 

// parse a Line 
String line ■ null; 
try { 

line H f ile_in.readXine ( ) ; 

) 

catch (lOException e] { 
break; 

} 

if (line =- null) ( // break if eof 
try { 

file_in, close O ; 

catch (lOException e) ( 

break; 

i- 

else if (line. startsWith ("name-" ) ) { 

this. name - line. substring (line. indexOf ('-' > + l).trim(); 

\ 

else if (line. start swith( "category-")) { 

this, category - Line. substring (line . indexOfC-' > + H.trimO; 

} 

else if (line.atartaWithCdescription-") ) { 

this, description - line. substring (line. indexOfC-' > + D.trimt); 

\ 

else if (line.startsMith("origin-") > { 

this. origin - line. aubstring (line. indexOf ('-' ) + l).trira(); 

> 

else if (line.startsWithClanguage-")) ( 

this .language - line. substring (line. indexOf ('-' ) + l).tritn()J 

} 

else if (line. start aHith<"raaddr--) ) { 
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this.SffiDR a line. substring (line. index' 

else if (line.startsWith("mport- ") > < 

String port_str - line .substring (line. indexOf ('<-' ) t 1) .trim Of 
thig.MPORT =■ integer. parselnt (port_str) ; 

i 

else if (line.startaHith<"mttl-")| < 

String ttl_atr = line. substring ( line. indexOf ('-' ) + l).trim(); 
this . MTTL = rnteger .parselnt {ttl_str> ; 

} 

else if <line.3wartsWith("id-") ) ( 

this. id = 1 ine. substring (line. indexOf ('-'> + 1> .trim<) ? 

\ 

else if Uine.startsWithCseklist=") ) ( 
Vector2 seklist = new Vector 2 O ,- 
Str ingTolceniser st = new StringTokenizer 

(line, substring (line. indexOf ('=') + D.triraO, " I") ; 
while <st.haaMoreTok.ensO> ( 

seklist .addElement (st .nextlokenO .trim () J ,- 

> 

this . SEKLi ST = seklist .toStringArray () ; 

> 

else if <line.startswith<'date-'*)) ( 

String date_str - line . substring < line . indexOf <'-' ) + D.trimO; 
this. date = Long .parseLong (date^str) ; 

} 

else if ( line. atartsWith(" schedule-") > { 

this. schedule - line . substring ( line. indexOf ('-' ) + D.triraO; 

} ■ . 

else { 

/" ! ' 

* Uncomment below if you want strict formating of the Files. 

throw new AnnouncementException 

(ohj_nsnie + ".parse: the CDP file cannot be parsed"); 

) 

] 

} 

/" 

* CompasBS a datagram packet that represents this CDP packet going out to the 

* specified address and port number. This packet is UDF encapsulated SAP/SDP 

* session announcemnet protocol. All appropriate fields, not defined as 

* <code>null</code>, are used to make up this packet. 
* 

*■ eparam addr destination address string. 

* eparam port destination port number. 

* e return a datagram packet consisting of the valid CDP (5AWSDP) fields. 

V 

public DatagramPacket compose (String addx_str, int port> { 
Vector 2 temp_vec - new Vector2(); 
SAPPacJtat sap ■ naw SAPPacketO; 
SDPPaeket sdp « new SDPPacketO; 

/* 

» compose adp 
"I 

It o 

sdp . origin. username - "cdp"; 
sdp. origin. session_id - id; 

sdp. origin. version - String. valueOf (Tim«tamp.get_current 0 ) ; 
adp. origin. network—type - •IN"; 
sdp. origin. addresa_type - "IP4"i 
try ( 
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s dp, origin. address - lnetAddress . getLocalHost O . 



catch [UnknownHostException e) ( 

> 

// s 

if (nane !- null} { 
sdp. name ■* name; 

\ 

II i 

if (description != null) { 
sdp. info = description; 

} 

// c 

if (MADDR != null) t 

sdp. connect ion = new SDPConnection <) ; 

sdp. connect ion . networ)e_type - "IN"; 

sdp. connection. address_type - 

sdp. connect ion. address - MADDR; 

sdp. connect ion. ttL = String , valueOf (MTTL) ; 

> 

// a 

if (category !- null) { 

temp_vec.addElement ("cat : " 4- category) ; 

} 

if (origin !- null) { 

temp_vec .addBlement CX-orig; " + origin) ,- 

) 

if (language !- null) { 

te:np_vec.addEleraent Clang;" + language); 

} 

if (SEK1IST !- null ii SEKLISTtO] !- null) \ 
Spring temp_str - SEKLIST[0]; 
for tint i - 1; i < SEK1I5T . length; i*+) { 
if ( SEKLI5T [ i] !- null) { 

temp_9tr +- "1" +■ SEKLI5T [i] ; 

} 

\ 

temp_vec.addElement [ "X-sekliat : " + temp_str) ; 

) 

if (date != -1) < 

temp_vec.addElement ("X-date:" + String. valueOf {date) ) ; 

) 

if (schedule !- null) < 

tenip_vec.addElement ("X-sched: " + schedule); 

) 

sdp. attribute - terap_vec.toStringArray ( > ; 
// t -permanent session 
sdp. active - new String [1]; 
sdp. active {0] - "0 0"; 

// m 

sdp.mediatO] -new SDEMedia ("audio". String . valueOf IMPORT) , "RTP/AWJ? 
/* 

* compose sap 
•/ 

sap.nies3age_type - SAPPac)iet.HI_AMNOUHCE; 

sap. encryption - false; 

sap. compress ion - false; 

sap.auth_ headerlen - 0; 

sap.msgicL-haah - 0; 

try { 

sap. source - rnetAddress.getLocalHost t) .getAddreaa O ; 

} 

catch (UnknownHoatException e) { 
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) 

gap.paylo^d ■ sdp. compose <) ; 
this. data = sap . compose () ; 

InetAddreas addr = null; 
try ( 

addr - InetAddie33.getByName (addr_str) ,- 

i 

=atch (UnknownHoatException e) { 
} 



return new DatagramPacket (data, data . length, addr r port); 



* Cnmposes an ascii file that represents thia CDP packet. All appropriate 

* fields, not defined a3 <code>null</'code>, are used to make up this 

* packet. 

* iparara String filename (path) 

public void compose (String filename) ( 
File file = new File (filename] ; 
PrintWriter fout - null; 

try ( 

fout = new PrintWriter (new Buf feredWriter (new FileWriter (f i la) ) ) ; 

} 

catch (lOExceptLon e) ( 
} 

if (name !=■ null) { 

fout . print In ("name-" + name); 

^ 

if (description !- null) { 

fout .printlrl("de^C^iption-■ +■ description); 

> 

if (category !=• nulll ( 

fout .println("category-" + category)? 

> 

if (origin !■» null) { 

fout .println ("origin-" + origin); 

) 

if (language !- mill) { 

fout.printlnClanguage"*" t language); 

) 

if (MADDR !- null) ( 

fout .println("maddr-" +• MADDR); 

} 

if (MPORX !- -1) i 

fout .printlnCtnport-" + MPORT) ; 

> 

if (MTTL i- -1) { 

fout. print in <-mttl-" + MTTL); 

) 

if (id 1- null) { 

fout .println ("id-* + id); 

) 

if (3EKLIST !- null «« SEKLIST[0) 1- null) ( 
String temp_jstr - SEKLIST [0 ] ; 
for (int i - 1; i < SEKLIST. length; i++) ( 
if <SEKLIST[i] !- null) { 

temp_atr +- "I" + SEKLIST [i]; 

} 

> 



147 



WO 00/79734 



PCT/LS00/I6913 



17 14 30:23 1999 



9 



fout.println("sekli s t-' temp_str) ; 

if (date !- -1) { 

f out. print In ("date-" + String .valueOf (date) ) ; 

if (schedule !- null} { 

f out .println ("schedule-" +■ schedule) ; 

i 

try { 

f out. close 0 r 



/** 

* Composes a datagram packet that repreaents an empty CDP packet. 

* This packet should be instantiated for receiving purposes. It autQiuatieaLly 

* generates a packet with the internal buffer of the maximum length. 

* dreturn a datagram packet with empty buffer. 
*! 

public static DatagramPacket compose () \ 
byte[] buf = new byte [MAX_BUFLEN3 ; 

return new DatagramPacket (buf , buf . length) ; 



catch (Exception e) ( 



} 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RASt : [Maddr Dispenser Class] 

* $<marconi.maddr ,>MaddrDispenser , java -vl . 0 (prototype version), 1998/11/11 S 

* 3jdkl.l.7, -riK. 
*/ 

package marconi .ut il ; 

import java.io.*; 

import java.r.e^.*; 

import java.ut LI. Hashtable; 

* The <: C ode>MaddrDi3penser<;/code> class distributes a damain-wide multicast 

* address for each station, where domain refers to reachability of RAS . unlike 

* the class <code>MaddrServer</code> it creates multicast channels between HAS 

* and IRCs. Thus, each RAS must include an instance of this object. And 

» assuming a carefully designed domain edges, different instances can utilize 

* the same addresses. 

* <P> 

* We can use administratively scoped address 3pace here, which will el1.1n3.nate 

* the problem of RAS-coverage (domain) overlaps. But for simplicity and to avoid 

* having to configure the organizational boundary routers, we simply assume 

* for now that there is a local RAS running and use "site-local" scoping 

* (IPv4 TTL-15) . 

* <p> 

* 3 author -riK. 

* ^version ^Revision: 1,0 S ■( 

* (Jsee marconi .util .MaddrException 

* Ssince prototype vl.Q 
*l 

public class MaddrDispenser { 
I* 

* Here we use a contiguous address block £::on the TTL scoped 

* multicast address spectrum: 

* [225.2.0.0 : 225.2.255.255] (site-local iif TTL-15) 

* Note that it avoids the administratively scoped IPv4 multicast spaces 

* [239.0.0.0 : 239.255.255.255] 
*/ 

final static int MADDR_LOWBOUND - 0x0000; // [225.21.0.0 
final static int MADDR_UPPERBOUHD - OxFFFT; // [ 225 .2 ] . 255 . 255 
final static String MADDRJBZFIJC - "525. 2"; // 225.0.0.0/16 
final static String RTCP_PFEFrX = "225.4"; // 

Hashtable registeredKaddrs - null; 

/•* 

* Creates a new instance of <code>MaddrDispenaer</code> where the next 

* multicast address to be allocated is initialised to the lower bound 

* of the address space. All addresses are recycled. 
V 

public MaddrDispenser () ( 

regiateredMaddra - new Hashtable () ; 

} 

/*• 

* Allocates and returns a new multicast address. It will first try to fill-in 

* any holes within its address space. In other words, it recycles freed 

* addresses. 

* 9retucn the new multicast address. ' . 

* gexception MaddrExcept ion if it runs out ofjtha qJLv«n^muJ.ticast,addres8 
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* pool . 

public synchronized InetAddress next(] throws MaddrExcept ion ( 

// find an empty multicast address apace 
int maddr - MADDR__LOWBOUND; 
InetAddress inet_maddr - null; 

while (registeredMaddrs. contains (new Integer (maddr )) 
id ++maddr <=• maddr_UPPERBOUND> ; 

// return newly assigned address 
if (maddr <- MADDR_UPPEF30UND) ( 
try { 

inet_maddr = InetAddress .getByNarae (toString (maddr) ) ? 

\ 

catch (UnknownHostException e) { 
e .pnntStackTrace () ; 

\ 

registeredMaddrs .put (inet_maddr, new Integer (maddr )) ; 
return inet_maddr; 

) 

else { 

throw new MaddrExcept ion ("Multicast address out of bound-*); 

) 

} 

/** 

* Free the address. Return the multicast address back to its pool. 

* Sparam inet_maddr the address to be freed. r £ ■ 
*J 

public synchronized void remove (InetAddress inet_jnaddr) ( 
registeredMaddrs . remove (inet jnaddr) ; 

} 

/* 

* Construct the full IB address format. 
*/ 

protected String toString {int addr) { 

return MADDRJREFIX + { (addr »> 8) 4 OxFF) -(-■,* + {addr i OxFF); 

} 

/** 

* Return RTCP multicast address of the given RTP multicast address. The details 

* ot mapping RTP to RTCP address is hidden. 

* Sparam rtp_jnaddr the RTP multicast address. 
*/ 

public static String rtep_map (InetAddress rtp_j«addr) { 
byt e ( 1 raw * rtp_joaddx . get Addres s < > ; 

return RTCPJPREFIX 4- + ( (raw[2] « 24) >» 24) + "." + (Uaw[3) « 24) »> 24); 

I 

/** 

* Return IPv4 address as 32bit integer. 

* Gparara maddr the inet address to be converted. 

'/ 

public static int addc_to_int (InetAddress maddr) ( 
bytet] raw - maddr .get Address () ; 
int int32 - raw[0] <<: 24; 
int32 I- <raw[l] « 24) »> 8; 
int32 I- <raw[2] « 24) >» 16; 
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int32 l» <raw£3] << 24) i>> 24; 
return Lnt32; 
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/* marconiNot - Internet Radio Network 

* Diatributed Radio Antenna Server (RA5) : iMaddrserver Class] 

* S<marconi.util.>MaddrServer. java -vl . 0 (prototype version) , 1938/10/12 $ 

* gjdkl.2, -riK. 

*/ 

package marconi .util; 

import java.rmi.*; 

import java . rmi . server . *; 

import :ava . nr.i . registry . LocateF.egistry ; 

import java.ic. 4 ; 

import java.net.*; 

import java.util.Hashtable; 

/*« 

* The <cade>KaddrServer</code> class manages the global multicast address 

* allocation to the Radio Station Client (RSC) channels. The current version 

* does not implement distributed approach. Therefor*, <code>MaddrServer</code> 

* acts as a centralized server where the RSCs can obtain their multicast 

* addresses via a specific request (PMI request] . 
' <p> 

* ^author -riK. 

* aversion $E«vision: 1.0 S 

* 9see rrarconi. util. MaddrExcept ion 

* 9since prototype 1.0 
*/ 

public class MaddrServer extends UnicaatRemoteObject 
implements Maddr Serverlnterf 1 

final static String obj_na«e - "marconi. util. MaddrServer"; 
/** 

* The port number for multicast address. 
■/ 

public final static int MADDRSERV_FORT - 88 89; 

* Here we use a contiguous address block from the TTl scoped 

* multicast address spectrum: 

[225.1.0.0 : 225.1.255.255] (global iff 128 < TTL < 255> 

* Note that it avoids the administratively scoped IPv4 multicast space: 

* [239.0.0.0 : 239.255.255.255] 

final static int MADDRJ.OWBOUND - 0x0000; // [225.1]. 0.0 

final static int MADDR_UPPERBOUTJD - OxFFFFf // [225 . 1] . 255 . 2 55 

final static String MADDR^PREFIX - "225. 1"; // 225.0.0.0/16 

Hashtabl* registeredMaddrs - null; 

/** 

* Initialises the multicast address server. 
*/ 

public MaddrServer () throws RemoteException { 
registeredMaddrs - new KashtableO; 

) 

' ' * Allocates and returns a new multicast address. It will first try co fill-in 

* any holes within its address space. In other words, it recycles freed 

* addresses. 

* Sreturn the new multicast address. 



152 



WO 00/79734 PCT/LS00/I6913 
MaddrServBx . java ^^Thu Jun 17 14:30:53 1999 

* @axc«ption MaddrException if it runs out i 

* pooL. 
*/ 

public synchronized inetAddress next i ) 

throws RemotsException, MaddrException { 

// find an empty multicast addresa apace 
int maddr - MADDR_LOWBOUND; 
InetAddresa inet_raaddr = null; 

while (registeredMaddrs. contains (new Integer (maddr) ) 
ii ++maddr <= MADDR_UPPERBOUND I ; 

// return newly assigned address 
if (maddr <- MADDR_UPE ERBOUMD ) < 
try ( 

inet_maddr = InetAddrea 3 . get ByName (toSt ring (maddr )) ; 

J 

catch (Exception e) [ 

e . pr intStacltlrace ( ) ; 

} 

registeredMaddrs. put (inet_raaddr, new Integer (maddr) ) ; 
return inet_maddr; 

> 

else i 

throw new MaddrException ( "Multicast address out of bound."); 

} 

* Free the address. Return the multicast address back to its pool. ,« 

* 3param inet_maddr the address to be freed. 
*/ 

public synchronized void remove (InetAddress inet_^addr) 
throws RemoteException { 
registeredMaddrs .remove <inet_roaddr) ; 

I 

/* 

* Ccnstruct the full IP address format . 
*/ 

protected String toString (int addr) { 

return MADDR_PREFEX + "." + ( (addr »> 8) £ OxFF) + "." + <addr s OxFF); 

} 

/** 

* The main method executes the server setup process. 

■*/ 

public static void main (String args[]) throws RemoteException { 

If check arguments (rtsp server) 
if (arga. length !- C) { 

System. err. println ("usage: \n" + "MaddrServer") ; 

System. exit (-1) ; 

} 

System. setErr (System. out) ; 

// Create and install a security manager 

System. aetSecurityManager (new RHISecurityHanager () >; 

// Setup and start the server on local host 
try ( 

LocateRegiatry .createRegistry (MRDDRSERV_PORT) ; 
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Maddr Server mad3rServer - new MaddrServer () ; 

Naming- cebind ("//: " +■ maddrserv^port + V" - obj_name, maddr Server) ; 
System. out .print In I InetAddresa . getLocalHoat ( ) 

+■ " bound in registry at port * 

+■ MADDRSERV^PORl) ,* 

\ 

catch (Exception e) { 

System, err. println (obj_name + ".main: * + e . getMessage ( ) ) ; 
e . pcintStackTrace ( ] ; 
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1 



EXTENSION Of- . . 



* 3 (♦) Vector. java 



1.60 99/0V30 



* Copyright 1994-1998 by Sun Miercsystems, Inc., 

* 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. 

* All rights reserved. 

* This software is the confidential and proprietary information 

* of Sun Microsystems, Inc. ("Conf idantial Information") . xOU 

* shall not disclose such Confidential Information and shall use 

* it only in accordance with the terms of the license agreement 

* you entered into with Sun. 
V 

package marconi . ut i 1 ; 
/** 

* This class extends java.util .Vector so that it's capable of returning its 

* elements as an array of java. Lang. String. 

« eautor -riK. 

* @see java.util. Vector 
*/ 

public class vector2 extends java. util .Vector { 



* Constructs an empty vector so that its internal data array 

* Das size <tt>10</tt> and its standard capacity increment ia 

* lero. 
V 

public Vector2 () { 
super (13) ; 

\ 

. . 

* Returns a string array representation of this Vector, containing 

* the String representation of each element. 
*/ 

public synchronised String!) toStringArray < ) ( 
String [] result - new String [elementCount] ; 
System. arraycopy (elenentData, 0, result, 0, elementCount); 
return result; 

> 
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'* msrconiNet - Internet RaoTa Network 

* Distributed internet Radio server (DIRS) : [Maddr Server interface] 

* $<marccni.util.>Maddr5erverInteri. java -vl . 0 (prototype version), 98/8/19. 

* ejdkl.2, -ciK. 

package marconi . util; 

import java.rnti.*; 

import jawa.net . InetAddx ess; 

/** 

* This interface provides centralized distribution of global multicast addresses. 
*/ 

public interface MaddrServerlnterf extends Remote { 

public inetAddress next() 

throws RemoteException, MaddrException; 

public void remov* (met Address maddr) 
throws RemoteException; 
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/* maxconiNet - Internet Radio Network 

* Distributed Radio Antenna Server <RAS> : tSaae€4 Wrapper Claas] 

* $<marconi.util->Baae64 . java -vl . 0 (prototype versiun) , 1999/05/13 S 

* 9jdkl.2, -nK. 
*/ 

package marconi.util; 
import java.util. *; 
/». 

* This class is a Base64 wrapper for ASCII representation of BINARY data. 

* It follows the PEM encoding formula. 

* <p> 

* Gauthor -riK. 

* ^version SRevisian: 1.0 5 

* Gsince prototype vl.O 
«/ 

public class Base 6 J { 
/** 

* Haps binary to char. 
V 

private static int map(int c) ( 

if (c >" 0 44 c <- 25) returnic -t- 'A' ) ; 

if Ic >■ 26 44 c <= 51) return <c - 26 * 'a'); 

if (c >= 52 44 c <=■ 61) returntc - 52 +■ '0'); 

if <c — 62) return ('■►'); 

if <c =- 63) return ('/'); 

elae return(-l) ; 

) 

■ /** 

* Maps, char to binary. 
*/ 

private static int unraap(int c> { 

if <c >- 'A' Si c <• 'Z'l return (c - 'A'); 

if |c >= 'a' it c <= 'z'] return (c + 26 - r a'>; 

if (c >= '0' 44 c <- '9') return<c + 52 - '0'); 

if (c — ' +' ) return (62); 

if (c =- V ) return (63) ; 

else return (-1) ; 

> 

/" 

* Decades caae64. 
*/ 

public static byt«U decode [byte [] string) { 
int length, i, j; 
byte[] buf - { 0 > r 

if (string — null) t 
return buf; 

\ 

length - string. length; 

buf - new byte [( (length /A) * 3) + 1]; 
fox (i - j - 0; i < length; i +- 4, j +- 3) ( 
while (i < length 64 string [i] !- ' -' 4 4 

! (string [i] >- 'a' 46 string[ij <= 'z') &4 
! (string [i] >- 'A' 44 stringti] <- ' Z' ) 44 
! (stringti] >- '0' 44 stringti] <- '9')) i++; 
buf[jl - (byte) < (unmap (string [i] > i Cx3f) « 2); 
if (string [i+11 — '-') { 
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buf[j+i] . o; 
break; 

bu£[jl 1= (byte) < (unmap {string I i + 1 ] ) i 0x30) » 4); 
buf(J + H - (byte) ( (unmap <strir.g[i + l] I i 0x0 f) « 4); 
if (string [i+2] =-•=•) < 

buf[j+2] =. 0; 

break; 

buf[j+l] 1= (byre) ( (unmap<atiinijti+2] ) 4 0x3g) » 2); 
bu£[j+2) = (byte) ( (unmap < string [i+2]) s 0x03) « 6); 
if <string[i+3; — '-' ) { 

buf[j*3] = 0; 

break; 

} 

buftj+2] I- (by^e) unmap { string [ i+3 ] ) i Qx3f; 

) 

return buf; 

\ 

/** 

* Encodes base€4. 
*/ 

public static byte[] encode (byte [ ) bin) { 
inn BLOCKS_PER_LINE - 18; 
int length, i, j, cnt; 
byteN buf - {0>; 

if (bin — null) ( 
return buff 

] 

length » bin. length; 

byte[] string - new byte [length +2]; 
System. arraycopy (bin, 0, string, 0, length) ; 
cnt - (((length + 3) / 3) * 4) + 2; 
cnt +- lent / (BLOCKS_PEH_LINE * t) ) ; 
buf = new byte I cnt J; 

for (i - j = cnt =- 0; i < length + .3? i +- 3, j +- 4> { 
buf[jj = (byte) map( (atring[il S Oxfc) » 2); 
buf[j+l] = (byte) (map (( (string [i] 4 0x03) « 4> I 

( (string [i+1] & OxfO) » 4))); 
if (string — 0) ( 

buf[j+2] - buf [j+3] - (byte) 

j +- 4; 

break; 

buflj+2] - (byte) (map (( (string [itl] & OxOf) « 2) I 

( (string [i+2] 6 OxcO) » 6))); 
if (string [i+2] — 0) ( 

buf [ i+3 I - (byte) 

j +- 4; 

break; 

> 

buf[j+3] - (byte) map (string [i+2) & 0x3f > ; 
if (cnt >- (BLOCKS_PER_LINE - 1)) ( 

buftj+4) - (byte) ' \n' ; 

buftj+5) =- (byte) ' '; 

j +- 2; 

cnt - 0; 

) 

else cnt++; 

} 

return buf; 

) 
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* Test function. 
*/ 

public static uoid main(String args[]> ( 
// byteU in - ((byte)Oxff, (byte)0x33, (byte) 0x55 } ; 

// byte[] out - encode (in); 

byte 11 on"- ■ encode (args [0] .getBytes <)( ; 

System. out. println (new Stcing (out) ) ; 

System. out. println (new String (decode (out) ) ) ; 

1 

\ 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (HAS ) : ISession Description ISDP) Claaa] 

* S<marconi.util.sd.>SDPPacket. java -vl . 0 (prototype version), 1999/03/15 S 

* endlcl.2, -riK. 

package marconi .ut i.1 . sd; 

import java.util . StringToltenizer ; 
import raarconi.util.Vector2; 

* This class encapsulates and parses the <code>iuedia</code> field of Session 

* Description Protocol. 

* <p> 

* Gauthor -riK. 

* aversion fRevision: 1.0 S 

* dsee marconi.util.sd.SDPPacket 
« dsince prototype vl.O 

*/ 

public class SDPMedia { 
/•* 

* The session name. 
*/ 

protected String media - null; 
/<"• 

* The session information. , ; 
*/ 

public String title = null; 

1 * The media connection information {multiple specification not supported). 
V 

public SDPCo.inection connection » null; 
/•* 

* The bandwidth information. 
*/ 

public String bandwidth - null; 
/** 

* The encryption key. 
*/ 

public Stri.ig key - null; 
/** 

* The media attributes , 
*/ 

public String attributed - null; 
/**• 

* The media type (audio, video, application, — etc.) . 
*/ 

private String reediaType - null; 

i * The transport port to which the media stream will be sent. 

*/ 

private String mediaPort - null; 
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* The transport protocol. 
*/ 

private String medialransport - null; 
/** 

* The media formats. 
V 

private StringU nediaFormat = null; 
/** 

* The default constructor with specific format list. 
*/ 

public SDPMedia (String type, String port, String transport, String [] format) { 
rnediflType = type; 
mediaPort - port; 
mediaTransport = transport; 
mediaFormat = format; 
media - compose <) ; 

} 

!** 

* The default constructor with default media format. 
V 

public SDPMedia (String type. String port, String transport) ( 
String [] fmt = <"0">; 
raediaType - type; 
media? ort = port; 
mediaTransport - transport; 

mediaFormat * fmt; ,t 
media ■ compose!); ,j 

» 

/*» 

* The constructor. 

V 

public SDPMedia (String media) { 
this. media ■ media; 
Vector2 temp_vec - new Vector2(); 
StringTokeniier st - new StringTokenizer (media, " 

if (st.hasMoreTcJtenaO ) { 

this.mediaType - st.nextToken () ; 

} 

if (st.haaMoreTokens O ) { 

this.mediaPort » at - next To ken ( | ; 

1 

if <st.haaMoreTok«no 0 ) { 

this. mediaTransport - at.nextToken ( ) / 

> 

while (st.hasMoretokensO ) ( 

tetnp_vsc . addElement ( at . next Token < ) ) ; 

\ 

this. mediaFormat - temp_vec.toStringArray <) ; 

\ 

/<■* 

* Returns the type of media. This variable is not directly accessible 

* because they are read-only. 
*/ 

public String get Type!) { 
return mediaType; 
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* Returns the port number for media communication. This 

* directly accessible because they are read-only. 
*/ 

public String getPort ( ) [ 
return mediaPort; 

\ 

* Returns the transport protocol used. This variable is not directly 

* accessible because they are read-only. 
*/ 

public String getTransport O ( 
return mediaTransport ,• 

\ 

* Returns the media format list. This variable is not directly accessible 

* because they are read-only. 

public Str-nglJ getFormatO ( 
return inediaFarmat; 

/** 

* Returns concatenated media description. 
*/ 

protected String compose 0 { 
String temp_str - ""; 

for (int i - 0; i < mediaFormat . length; i++) ( 

temp_str = temp_str +■ ( (i-=0) 7 ■":"■) -t- mediaFormat [ i] ; t! 

\ 

return rr.ediaType + " " + mediaPort + * ■ f mediaTranspcirt + " " + temp_str; 

} 

I 
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/* marconiNet - rnternet Radio network 

* Distributed Radio Antenna Server (BAS) : [Session Description (SDP) Class] 

* $<marconi.util.sd.>SDPFacket. java -vl . 0 (prototype version), 1999/03/15 5 

* ejdkl.2, -riK. 
*/ 

package marconi . util .sd; 
import java.utiL.*; 

This class encapsulates and parses the <code>connection</code> field of Session 

* Description Protocol. Currently only IP4 address type is defined by the 

* protocol. 

* <p? 

* ^author -riK. 

* aversion SRevision: 1.0 % 

* 3see marconi. util. sd . SDPPacket 

* Ssince prototype vl . 0 
*/ 

public class SDPConnection. { 
/** 

* The type of network. 
*/ 

public String network_type ■ "IN"; 

,> 

* The type of address. , ; 

*/ 

public String address_type - "IP4"; 
/** 

* The base multicast address for connection. 
*/ 

public String address - 
/*" 

* The connection ttl (time to live}. 
-/ 

public String ttl » ""; 

* The number of contiguous addresses including the base address. 
V 

public String count - "S 
/** 

* Default constructor. The subfielda take the default values. It is the 

* user' 3 responsibility to make sure that the required subfielda are 

* properly initialized. 

V 

public SDEConnection <) ( 
super { ) f 

> 

f * constructor. It does not check for the valid number of subfielda. This 

* simple parser uses the default values if the input is short of fields. 

public SDPCorinection (String connection) { 

StringTokenizer st - new StringTokeniier (connection, " "); 
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if (at.hasMoreTokens 0 ) ( 

this .n«twork_cype ■» 3t . nextToken < ) ; 

t 

if ist.hasMoreTokens {) ) ( 

this.address_type = st .nextTokenO ; 

if i adtJress_type . startswith ( " IP4 " ) I \ 
if (st.hasMorelokena () ) { 

String connect ionAddresS - st , nextToken ( ) ; 

5trin<jTokeni«r at2 = new stringTokeni zer (eonneetionAddress, "/") ; 
if (3t2 .hasMoreTokens 0 > ( 

this. address * 3t2 .nextToken < ) ; 

> 

if <3t2.hasMoreTokena()) < 

this.ttl = st2 . nextToken 0 ; 

} 

if (3t2.haaMoreloken3 () ) { 

this. count = st2 .nextTokenO ; 

J 

\ 

t 

8lse ( 

while (st . hasMoreTokens ( ) ) { 

this. address - address + " " ^ st . nextToken ( ) ? 

t 

this. address = address . trim O ; 

i 

* Returns the <code>String</code> of concatenated connect ion subfields. 

*l 

protected String compose*) ( 

return network_type + " * <■ address^type + " * t address 

+ (addrsss_type. equals ("IP4") ? + ttl + •/" + count : ""); 

\ 
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'* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) ; [Session Announcement Protocol Classl 

* 5<marconi.util.sd.>5AFPacket. java -vl . 0 [prototype version}, 1999/03/15 S 

* 3jdkl.2, -riK. 
V 

-ackage marconi . ut il - sd; 
.raport marconi . util . Timestamp; 



* This class encapsulates and parses the Session Announcement Protocol (SAP) 

* Packet. Wittiir. it, SDP packet in also encapsulated. Many of the security 

' related fields ace still being defined and thus not fully supported in this 

* version. It merely supports the parsing of these fields. For example, the 

* encrypted payload is not parsed and left to be handled by the next version, 

* or an abject that extends this, or an object that encapsulates this (parent 

* object} . 

* <p> 

* Included in the packet are the following fields: 

* <ul> 

* <li>version 

* <li>message type 

* <li encryption bit 

* <li>compreasion bit 

* <li>authentication header length 

* <li>messa<;e id hash 

* <li>originating source 

* <li>authentication header 
« <li>timeout 

* <li>payload 

* </ul> 

* <p> 

* Sauthor -riK. 

* Aversion SReyiaion: 1.0 S 

* Ssee marconi. util. sd.MalformedSDException 

* gsee marconi. util. 3d. SDPPacket 

* 9since prototype vl.O 

oublic class SAPPacket implements java. io . Serializable ( 

final static String obj_name - "marconi. util. SAPPacket"; 



* The version ID. 
V 

public final static in.t version - 1; 
/** 

* The message type. 
V 

public byte mesaage_typ« - mt_juinCKJHCE; 
/** 

* The encryption bit. 
V 

public boolean encryption « false; 
/** 

* The compression bit. 

public boolean compression false? 
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* The authentication header Length. 
V 

public short auth_headerlen - C; 
/** 

* The message identifier hash. 

*/ 

public short m3gid_hash = 0; 
/" 

* The orginating source. 
*/ 

public hyte[] source = new byte [4]; 
/** 

* The authentication header. 
V 

public int[] auth_header = null? 
/** 

* The timeout. 
V 

public int timeout - 0; 
/** 

* The text payload (if encrypted contains the privacy header field) . 
*/ 

public byteM payload - null; 

/** ! : 

* The date and time of the packet created. 

*/ 

public long timeStamp » -1; 
/** 

« The maximum payload buffer length (currently IK bytes « limited by SAP) . 
*/ 

public final Static int MAX^BDTLEN - 1024; 
/** 

* The <cade>announce</code> message type. 
*/ 

public final static int MTJUTOOUNCE - 0; 
/** 

* The <code>delete</code> message type. 

*/ 

public final static int MT_DELETE - lj 
/** 

* Raw data containing the byte-array representation of the packet. 
•/ 

private byt*[] data - null; 
/** 

* Creates an empty SAP packet. 
*/ 

public 5MPacket() { 

this. timeStamp - Timestamp.get_current 0 ; 

\ 

/*» 

» creates SAP packet from a byte array. 
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* Sparam ouf the byte array that contains SAP/501 
*/ 

public EAPPa=ket (byte [] but) throws Malf ormedSDExeeption ( 
parse (buf) ; 

this .timeStamp - Timestamp . gat_current ( ) ; 

I 

/" 

* Obtains a SAP packet by parsing a byte array. 

* fiparam buf a byte array that contains SAE/SDF. 
*/ 

public void parse (byted buf) throws Malf ormedSDException { 
int bO, bl, b2, b3, i = 0; 

// main sap header 
bO - buf[i); 

bl = (buf[i+l) « 24) >» 24; 
B2 = (bufU+2] << 24) »> 24; 
b3 = (buf[i + 3] « 21) 24; 

int main_header = bO « 24 1 bl « 16 I b2 « 3 I b3; 
i +=■ 4; 

if (version !- ( (main_header i OxeOQOOOOO) >» 29} ) { 
throw new Malf ormedSDException 

<obj_name + ".parse: incompatible version received."); 

this.message_type - (byte) ( (main_header * OxlcOOOOCQ) >>> 26) 
this. encryption » (main_head«r i Ox020aOGOO) > 0; 
this. compression - (main_header i 0x01000000) > 0; 
this.auth_headerlen - (short) ( (mainjieader 4 OxOQf f 0000 ] »> 
this.msgid_hash = (short) (main_header s OxOOOOffff); 



// originating source 
this.sourcejO] =■ buf[i]; 
this.sourcell] - buf[i+lj; 
this.3Qurce|2] =buf[i+2]> 
this .source|3] -buf[i+3]; 
i +- 4; 



// authentication header 

this. ant h_header = new int [auth_headerlen| ; 
for (int j - 0; j < auth_headerlen; i +- ++j*4) { 
bO - buf [i] f 

bl - (buf[i+l] « 24) »> 24 f 
b2 =■ (buf(i+2] « 24) »> 24,- 
b3 - (buf [1+3] « 24) »> 24; 

this.authjieadertjj - bO « 24 I bl « 16 I 62 « 8 1 b3; 

} 

// 32 -bit tinwout field 
if (encryption) ( 
bO - buf til; 

bl - (buf[i-H] « 24) »> 24; 
b2 - <buf[i+2] « 24) »> 24; 
b3 - <buf[H-3] « 24) 24; 

this. timeout - bO « 24 I bl « 16 I b2 « 9 I b3; 
i +- 4; 

) 

// payload 

int payloadlen - Math. rain (MAX_BUFLEN, buf. length - i) ; 
this. payload - new byte [payloadlen) ; 

System. array copy (buf, i, this. payload, 0, payloadlen); 
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] 

/** 

* Returns the buffer that represents this SAP packet. 

* Sretutn byte array representation of this SAP packet (including payload) . 
V 

public byteU compose () < 

int bO, bl, b2, b3, i, y, 

It integrity checu 
if (payload « null) ( 
return null; 

I 

if <auth_Jieader !- null) ( 

/ / just in case they don't match 
auth_headerlen = (short) auth_header. length; 

> 

int length = <J t <J + autlLheaderlen * 4 + 

((encryption) ? 4 : 0) + payload. length; 
data = new byte [Length] ; 

// ir.ain header 

bO - version; 

bl = mes3aqe_type; 

b2 = (encryption! 7 1:0; 

b3 - (compression) ? 1 : 0; 

data[0] = (byte) <bQ « 5 I bl « 2 I b2 « 1 I b3l ; 

data[l] = (byte) (auth_headerlen) ; f , 

data [2] - (byte) (raaqid_hash » 8); 

data (3] = (byte) (magid_hash) ; 

data (4] » 3ource[0); 

data [5] - source (1); 

data [6] = source (2 ] ; 

data[7) = sourc«[31; 

// authentication header 

for (j - 0, i - 6; j < auth_headerlen; i +- ++j*4) { 
datati] = (byte) (auth_header [ j J » 24); 
data(i+l] - (byte) <auth_header ( j 1 » 16); 
data[i+2] - (byte) (auth_header [ j ] >> 8); 
data[i+3] =■ (byte) (auth_header [ j ]) ; 



U timeout field 
if [encryption) ( 

dat*[i] ■ (byte) (timeout » 24); 

data[i+lj - (byte) (timeout » 16); 

dat«[i+2] - (byte) (timeout » 8); 

data[l+3] - (byte) (timeout) ; 

i +- 4; 



// payload 

System. arraycopy (payload, 0, data, i, payload. length) ; 



return data; 

} 
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/* marconiNet - internet Radio network 

* Distributed Radio Antenna Server (SA5) : [session Description (SDP) Claaal 

* 5<marconi.util.sd->SDPOrigin. java -vl . 0 (prototype version), 1399/04/06 $ 

* ejdkl.2, -riK. 
*/ 

package marcorti .util .3d; 

import j a va . ut i 1 . S t r ingTo ken i z er ; 

1 ■• This class encapsulates and parses the <code>origin</code=> field of Session 

* Description Protocol. 

* *p> 

* @author -riK. 

* Sversion $Re«ision: 1.0 S 

* Ssee marconi.util . 3d. SDPPacltet 

* @since prototype vl . 0 
-/ 

public class SDPOrigin { 
/•* 

* The userr.ame. 
*/ 

public Strir.g use mama - 
/" 

* The session id. . * 
V , i 

public String session_id - "0"; 

/** 

* The announcement version. 
*/ 

public String version - "0"; 
/»* 

* The type of network. 
V 

public String network_type - " IN" ; 
/** 

* The type of address . 
*/ 

public 3tring addre33_type - "IP4"; 

/** 

* The originating network address. 

V 

public String address - ",• 
/** 

* Default constructor. The subfielda take the default values. It is the 

* user's responsibility to make sure that the required 3ubfields are 

* properly initialized. 
*/ 

public SDPOrigin () < 
super ( ) ; 

} 

' ' * Constructor. It does not check for the valid number of subfielda. This 

* simple parser uses the default values if the input is short of fields. 
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V 

public SDPOrigm (String origin) < 

StringTokeniaer st - new StringTokeniier (origin, • 

if (st.hasMoreTokens ()> i 

this .username = at .nextToken O ; 

) 

if (st .hasMoreTokens ( ] ) ( 

this.ses3ion_id - st.nextloken () ; 

) 

if (st.hasMoreToker.s 0 ) { 

this. version = st .nextToken () ; 

1 

if |st.hasMoreTei(ens() > { 

this.network_type = st . nextToken ( ) ; 

\ 

if ist.hasMoreTokens ()> { 

this .addreas_type - at . ne*tToken ( ) ; 

if 1st .DasMoreTokens () ) { 

this .address = st .nextToken ( ] ; 

^ 

\ 

/** 

* Returns the <code;>String</ccde:> of concatenated origin subf ieids . 
*/ 

protected String compose <) ( 

return username + " " + session_id + " " t version t " ' t , 
+ net«ork_type + " " + address_type + " • + address; f . 



170 



WO 00/79734 PCT/US00/16<113 
3DCT»ck«t.i*« Thu ^ 17 4:33:13 1999 1 

/* marconiNet - Internet Hadio Network 

* Distributed Radio Antenna Server (RAS) : (Seasion Description (SDP) Class] 

* S <marconi. util. 3d. >SDPPacket. java -vl.O (prototype version) , 1999/03/15 S 

* ajdkl.2, -riK. 

package marconi.util .ad; 

import java . Util • * ! 

import java.io.*) 

import marconi.util-Timestanvp; 

import marconi.util.Vector2; 

/ * This clas3 encapsulates and parses the Session Description Protocol (SDP) 
« Packet. It does not support parsing of the full SDP fields but only enough 

* to support CDP (Channel Description Protocol) . Thus, it does not parse into 

* the aubfields of SOP if they are not to be used for channel, description, 

* Further, the parser tolerates other passive errors such as the existence of 

* fields that are not defined. However, the composing and parsing of SDP is 

* 100% compliant with the standard specification. In order to facilitate this 

* the parser strictly checks for the order and the existence of the required 

* fields. 

* <p> 

* The syntax of the SDP fields are given below: 

* <ul> 

* <li>v-0 

* <li>o-slt;usernameSgt; slt;session idsgt; sit; versiontgt; filtfnetwork typaigt; 

* tlt?address typeigt; sit; address 4gt; • • 

* <li>a-filt; session namesgt; ; t 

* <li>i-slt; session descriptiontgt; 

* <li>u-Slt;uriigt; 

* <li>e-Slt;eraail addresssgt; 

* <li>p-6lt; phone numberigt; 

» <li>e«slt; network typeSgt; *lt; address typetgt; sit; connection addressigt; 

* <li>b-Slt;modifiersgt; :4lt;bandwidth-value*gt; 

* <li>t-slt; start timesgt; sit; atop timesgt; 

* <li>r«S It; repeat intervalsgt; 4lt;activ» durationigt? sltjliat of offsetaSgt; 

* <li>z=-S It; adjustment timefigt; *lt; of f setSgt; ... 

* <li>k-Slt;methodSgt; 

* <li>k-Slt;methodSgt; : Sit; encryption keysgt; 

* -eli>a»slt;attributeigt; 

* <li>a»slt;attributetgt; : sit; valuesgt; 

* <li>m«Slt;media4gt; tlt;portigt; sit; transpoitigt; *lt;fmt listtgt; 

* </ul> 

* <p? 

* aauthor -riK. 

* aversion SRevisian* 1.0 * 

* 3 see marconi.util.sd.MalfonuedSDException 

* 8 see marconi.util. sd.SDPOrigin 

* £se« maccoai.uttl.sd.SDPKedia 

* 6 see marconi.util. ad. SDPConnection 

* asee marconi.util. ad. SAPPacket 

* asince prototype vl . 0 

public class SCPPacket implements java.io.Serializable ( 

final static String obj^name - "marconi.util. SDPPacket"; 

/•* 

* The protocol version. 
*/ 

public final static int version - 0; 
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* The owner/creator and session identifier, 
public SDPOrigin origin - new SDPOrigin ( ) • 
/** 

* The session name. 
*/ 

public String name = 
I** 

4 The session information. 



public String info - null; 
/** 

* The 'JRI of description. 
*/ 

public String uri = null; 
/** 

* The contact email address. 
*/ 

public String [] email = null; 
/** 

* The contact phone number. 
*/ 

public String[] phone = null; 
/** 

* The session level connection information. 
*/ 

public SDPConneetion connection = new SDPConneetion 0 ; 
/** 

* The bandwidth information. 
V 

public String bandwidth - null; 
/** 

* The time zone adjustments. 
*/ 

public String zone - null; 
/** 

* The encryption key. 

*l 

public String key - null; 
/** 

* The session attributes. 
«/ 

public String [] attribute - null; 

1 * The active times (HTP in seconds = Oh on January 1900). 

public String [] active - CO 0"J; 

/** 

* rhe repeat times. 
*/ 

public String {] repeat - null; 



*/ 
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* The media description. 

public SDPMediaU media =■ new SDPMedia [MAX_kediacOIJNT] ; 
/** 

* The date and time of the packet created. 
*/ 

public long timeStamp - -1; 
/** 

* The number of media descriptions - 
public int mn = 0 ; 

/** 

* The maximum number of media descriptions . 
*/ 

public final static int MAX_MED I ACOUNT - 1Q; 

* Raw data containing the byte-array representation of the packet, if it has 

* one . 

V 

private bytetl data = null; 
/** 

* Creates an empty SOP packet. t* 
*t <.'■ 

public SDPEacketO { 

this. timeStamp = Timestamp.get_current () ; 

} 

/** 

* Creates SDP packet from a (received) SAP payload. 

* eparam buf a byte array that contains SDP. 

public SDPPacket (byte [] buf) throws MalforraedSDException { 
parse (buf) ; 

this. timeStamp - Timesta«p.get_Ourrent () ; 

} 

/" 

* Creates a 5DP packet from a file. 

* Sparam file pathname to where the SDP-file is located. 

public SDPPacket (String file) throwa Malf ormedSDException { 
parse (file) ; 

this. timeStamp - Timeatainp.get_current () ; 

) 

1 * Obtains a SDP packet by parsing the SAP payload. 

* Sparam buf a byte array that contains SAP payload (SDP content) . 
public void parse lbyte[] buf> throws MalforraedSDException { 

/* 

* Open packet buffer oa stream. 
*/ 
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Buf feredReader buf_in - new Buff eredReader ( new 
[new ByteAxraylnputStreaiMbuf ) I ) ; 

try \ 

parse (buC_in) ; 
buf_in- close () ; 

catch (Malf ormedSDException e) { 
throw new MalformedSDException 

(obj_na.-ne + ".parse: packet cannot be parsed."); 

) 

catch HOException e> t 
) 

\ 

/** 

* Obta-na a 5 DP packet from a file. 

* Gparam file_path name and path of the SDF announcement file, 
public void parse I String file_path) throws MalformedSDException { 

/* 

* Open file. 
*/ 

File file = new File ( f ile^path) ; 
Buf feredReader file_in = null; 
try < 

file_in = new Buf feredReader (new FilsReader (file) ) ; t t 
parse (file_in) ; ti 
f ile_in. close () ; 

> 

catch (FileNotFoundException e) I 
e. print StackTr ace () ; 

} 

catch (MalformedSDSxception e) { 
throw new MalformedSDException 

(obj_name + ".parse: file cannot be parsed.") ; 

} 

catch (lOException e) { 
) 

) 

/" 

* Parse ordered fields. 

protected void parse (Buf feredReader parser) throws MalformedSDException { 
boolean perroc - false; 

parae_err: 

try ^ 

Vector2 temp_vec • new Vectors (); 
string line - parser. readLine 0 ; 

// v 

if (line !=- null &£ line.8tartaWith("v-") | { 

String v_str - line.substringdine.indexOf (' ) + l).trim(); 

System. out. println |obj_name + ".parse: " + line); 

if ( Integer. parselnt <v_str) > this. version) { 
throw new MalformedSDException 

<cbj_name + ".parse: incompatible version received."); 
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^ 

Line " parser . ceadLine <> ; 

} 

else { 

per roc - true; 
break par severe; 

} 

// 5 

if (line !- null « line.stattsWith("o-"| ) ( 

System, out .println <obj_name *■ ".parse: " + line); 

this. origin = new SDPOrigin (line. substring 

(line.itideicOf ('-' ) + D.trimO); 
line - parser. readLine () ; 

] 

else \ 

perror » true; 
break parse_err; 

] 

// a 

if <line !- null SS line.atartBWith<*s-"> ) ( 

System. out .println <obj_name + ".parse; " + line); 

this. name ■ line . substring (line, inflexof ('-' ) + D.trimO; 
line » parser. readLin* () ; 

] 

else { 

perror - true; 
break parse_err; 

I 

// i 

if (line I- null it, line.startsHith<"i=") I ( 

Systeirucut. println (cbj_name ".parses " + line); 

tula, info =■ Line. substring (line. indexOf ('-') +■ 1) .trim I) ,• 
line - parser. readLine O ; 

) 

// u 

It (line i= null si Line . startsWith < »u=") ) { 

System. cut. println (obijiame t ".parae; * +■ line) ; 

this.uri ■ line.aubatrincfdlna.inclexOf ('«' ) D.trimO; 
line - parser. readLin* () ; 

I 

!/ e 

IE <t«mp_v*c.»±t«0 > 0) K 

temp_rac. reaoveAllElenents ( ) ; 

i 

while (lin* I- null S.S line. startsWith <"e-") ) ( 

Syatftm. out .println (obj_namo + ".parse: * + line); 

temp_vec.addElement (line. substring ( line . indexOf ('-' } + 1) ,trim() ) ; 
line - parser . readLine 0 >" 

if [temp_v*c. sized > 0) i 

this. email - temp_vec.toStringXrray () ; 

i 

ft P 

if ltemp_vec.9ize <] > 0) { 
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removeAllElements () ; 

while (line ! = null 4' line . startsWith ( "p-" > ) { 

System, out . println (ob}_iiame + ".parse: " + linet; 

temp_vec.aetdElement (line .substring ( line. indexOf {' -' ) +■ 1) -trim() ) ; 
line = parser. readLine () ; 

) 

If (temp^vecsizeO > 0) ( 

this. phone = temp_vec . taStringArray ( ) ; 

) 

II c 

if (line != null SS line . startsWith ( "C=* ) ) ( 

System. out .print In (obj_name + ".parse; " + line); 

this. connection = new SDPConnection (line . substring 

(line-indexOf (' -' ) + 1) .trim I ) ) ; 
Line = parser. readLine () ; 

\ 

// b 

if (line != null iS line . startsWith < "b=" ) > < 

System. out .println (obj_name + ".parse: " *■ line) ; 

this -bandwidth = line. substring (line. indexOf ('-' } + l).trim()( 
line - parser. readLine O ; 

) 

U z 

it (line !- null si line . startsWith l"z=" ) ) { 

System. out .println (obj_name + ".parse: " + line); 

this.zone = line . substring (Line. indexOfC-' ) + l).trim(); 
line = parser. raadlin* I ) ; 

} 

// k 

if (line != null && 1 ine. startsWith ( "k=" ) ) { 

thia.lcay => Line , substring ( line . indexOf ('-' ) + D-trimO; 
line - parser . readLine () ; 

} 

// a 

if (temp_vec .aise 0 > 0) { 

temp_vec . removeAllElements < ) i 

) 

while (line !- nuLl £4 line. startsWith ("a-") ) ( 
S y stem. out. print In (ob j_jiame + ".parse: • + line); 

t«mp_vec.addElement(line.substrirg(line.indexOf ('-') + D.triraO); 
line - parser. readLi ne 0 ; 

} 

if (temp_vec.3ize<) > 0) { 

thi 3. attribute » terap_vec. toStringAxray 0 i 

} 

ft t 

it" (temp_wec.size() > 0) { 

t emp_ve c . removeAl 1 Element s < ) ; 

while (line != null S4 line. startsWith ("t-*) ) { 

System. out . print Ln (obj_nara* + ".parse: " + line); 



176 



WO 00/79734 PCT/US00/16<113 
:i»F*efc*t. 11111 J^17 14:33:15 1999 f 

temp_wec.a<JdElement (line .substring lline.indej 
line = parser . readline 0 ; 

\ 

if (torap_voc.aise ( ) > 0) ( 

this, active - temp_vec . toStringArray I ) ,- 

\ 

else { 

per r or ™ true; 
break parse_err; 

> 

// r 

if (temp_vec .size O > 0) ( 

temp_vec .removeAllElementa 0 ; 

ihiLe (Line != nuLl 44 line . startsWith ( " r-" ) ) { 

temp_vec . addELeraent (line .substring I line . indexOf (' ) + l).trim(t); 
line - parser. readLineO ; 

) 

if (cemp_vec.siie <) > 0) < 

this, repeat = temp_vec.toStringArray <> ; 

> 

while (line !■» null 4i line . startsWith { "m-" ) ) { 

System, out. urintln <ob j_r.ame + ".parse: " + Line) ; 

if (ma < MA3C_MED I ACOUNT ) { 
nm++; 

this, media (tui-1] - new SDPHedia (line. substring ff 
(line.indexOf (' -' > + D-trimO); ;! 
line - paraer.readLi.no O ; 

II i 

if (line !- null SS iine.startawith("i-*) ) { 
media [nui-1] . title - line, substring 
(line.indexOf ('-' ) + ll.trimO* 
line « parser. readLine {) ; 

} 

II c 

if (line 1= null ii line. startsWith ("c-" I ) ( 
media [nuv-1] .connection - new SDPCannection 

(line.substringdine.indexOf <'-' ) + 1) -trimO } ; 
line » parser. re adLi ne 0 ; 

\ 

It b 

if (line !- null if, line.startsWith("b"") ) { 
media [mn-1] .bandwidth - line . sub at ring 

(line.indexOf ('-' ) t U.trimOf 
line - parser. Leadline () ; 

) 

tl * 

if (line !- null it line. startsWith ("*-") ) { 
media [mn-1] .key - line. substring 

(line.indexOf ('-' ) + 1) .trimO ; 
Una - parser. readLine O ; 

> 

// a 

if <temp_vec.sizel) > 0) I 

temp_vec . removeAllElements ( > ; 

while (line !- null 4t line. startsWith ("a-*}) { 
temp_vec . addElement ( line . substring 

(Line.indexOf ('-' ) + l).trin()); 
line - parser. readLine (} ; 

) 
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if (temf>_vec.size() > 0) { 

media [mn-11 -attribute - temp_vec.toStringArray O ; 

\ 

> 

} 

if (mn =- 0) ( 

perror = true; 
breafc parss_err; 

I 

\ 

catch (IOException e> { 

throw new MaLformedSDException 

(obj_r.ame + ".parse: session description cannot be parsed."); 

\ 

/" 

* UncoirJTient below if strict formating is desired. 
V 

if iperror) < 

throw new Mali ormedSDException 

<obj_name + ".parse; session description cannot be parsed."); 

i 

} 

/** 

* Composes a byte array that represents this SDP packet. 

* All appropriate fields, not defined as <code>null</code>, are used 

* to mate up this packet. The syntax integrity check is not performed 

* during this process. The <eode>Malf ormedSDException</code> will he 

* thrown by the parser when the receiver of thia packet tries to parse 

* it. 

* 9 return a byte array consisting of the valid SDP fields in order. 
"/ 

public byteN compose () { 

ByteArrayOutputStream ba - new ByteArrayOutputStreamO ; 

PrintWriter ba_out = new PrintWriter (new QutputStreamWriter <ba) , true); 

ba_out.println("v=" + version); 
if (origin !- null) { 

ba_out.println("o-" + origin. compose ()> ; 

} 

if (name ! - null) ( 

ba_out .printlnfs"" + name); 

) 

if (info !- null) ( 

ba_out .print In ("i-" + info); 

} 

if (uri !- null) { 

bi_out.println<"u-" +■ uri); 

) 

if (email !- null) { 

for (int i - 0; i < email. length; i++) 
if (emailtil I- null) 

ba_ou t. print In ("e-" + email[i]); 

) 

if (phone !- null) ( 

for (int i. - 0; i < phone . length; i++) 
if (phone (i | !- null) 

ba_out.println("p-* + phone(i)); 

) 

if (connection !■ null) { 

ba_out. print In ("c™" + connect ion. compose (>) ; 

) 
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if (bandwidth !- nuTfl [ 

ba_out-println ("b-" +. bandwidth); 

) 

if (zone !- null) { 

ba_out.println ("Z-' *■ zone) ; 

\ 

if (key !- null) { 

ba_out.println(")t»" + key); 

> 

if (attribute !- null) ( 

for (int i - 0; i < attribute. length; it-*) 
if (attribute [i] != null) 

ba_out.prinsln( l *a-" + attribute [i] ) ; 

) 

if (active != null) < 

for (int i - 0; i < act ive . length j i++) 
if (active [i] !- null) 

ba_aut.println(*t-" + activeli]); 

! 

if (repeat != null) { 

for (int i = 0; i < repeat . length; L++) 
if (repeat [i] !- null) 

ba_out .println ("r-" + repeat li]); 

1 

for (int i - 0; i < media . length; i++) \ 
if (media [il !- null) { 

if (media [i] .media !- null) { 

ba_out.println("m-" *■ media[i] .media) ; 

} 

if {media [i] .title !- null) ( ( : 

ba^out-printlnCi-* +■ media [i] .title) ? 

) 

if <media[i] .connection !- null) ( 

ba_out.println ("c-" + media(i) .connection. compose O ) ; 

} 

if (media [i] .bandwidth 1- null) { 

ba_out .print in ("b-" + mediali]. bandwidth); 

) 

if (media (i] .key !- null) ( 

ba_out.println(")t-" + media fil -key) ; 

1 

if (media [i] .attribute !- null) { 

for (int j - 0; j < media [i] - attribute . length; 
if (tnedialil -attribute! j] !» null) 

ba_out.println("a-" ■•- media [i] .attribute [j] > ; 

) 

} 

> 

data - ba.toByteArray O ; 
ba_out. closed; 



return data; 

I 
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CELL BROADCAST IN A HYBRID GSM/CDMA NETWORK 



I. Field of the invention 

5 The present invention relates generally to wireless telecommunications, 

and specifically to advanced cellular telephone networks. 

II. Background of the invention 

The Global System for Mobile (GSM) telecommunications is used in 
10 cellular telephone networks in many countries around the world. Existing GSM 
networks are based on time-division multiple access (TDMA) digital 
communications technology. GSM offers a useful range of network services and 
standards. 

One of these GSM network services is a short message service - cell 
15 broadcast (SMSCB), for distributing short messages from a Cell Broadcast Center 
(CBC) via Base Station Subsystems (BSSs) in the network to subscriber units, or 
Mobile Stations (MSs). SMSCB messages may come from various sources, such 
as traffic and weather reports. These messages are broadcast to MSs in defined 
geographical areas, known as cell broadcast areas, over a dedicated Cell 
20 Broadcast Channel (CBCH) without requiring acknowledgment from the MS. 
The messages are received by the MS only in idle mode (i.e., when a telephone 
call is not in progress). SMSCB and related interfaces, protocol stacks and 
message formats are described, inter alia, in GSM standards 02.03, 03.41, 03.49 
and 04.12, which are incorporated herein by reference. It is noted, however, that 
25 there is no mandatory protocol defined by GSM standards between the CBC and 
the BSSs. Rather, the interface protocol is left to be determined by operators of 
the network and cell broadcast services, based on primitives defined by the 03.41 
standard. 

Code-division multiple access (CDMA) is an improved digital 
30 communications technology using direct sequence spread spectrum modulation 
techniques, which affords more efficient use of radio bandwidth than TDMA, as 
well as a more reliable, fade-free link between cellular telephone subscribers and 
base stations. The leading CDMA standard is TIA/E1A-95, promulgated by the 
Telecommunications Industry Association (TIA), which is incorporated herein 
35 by reference. In the context of the present patent application and in the claims, 
this standard is referred to as IS-95, by which name it is commonly known in the 
cellular communications industry. A recent version of the standard, known as 
TIA/ETA-95-B (hereinafter 1S-95B), has advanced networking features including 
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procedures for broadcast of messages over paging channels, which are 
monitored and received by compatible MSs. 

PCT patent application PCT/US96/20764 which is based upon U.S. 
patent application serial no. 08/575,413 entitled "Wireless Telecommunications 
5 System Utilizing CDMA Radio Frequency Signal Modulation in Conjunction 
with the GSM AInterface Telecommunications Network Protocol," filed 
December 20, 1995, which are assigned to the assignee of the present patent 
application and both incorporated herein by reference, describes a wireless 
telecommunications system that uses a CDMA air interface (i.e., basic RF 

10 communications protocols) to implement GSM network services and protocols. 
Using this system, at least some of the TDMA base stations (BSSs) and subscriber 
units of an existing GSM network would be replaced or supplemented by 
corresponding CDMA equipment. CDMA BSSs in this system are adapted to 
communicate with GSM mobile switching centers (MSCs); via a standard GSM 

15 A-interface. The core of GSM network services is thus maintained, and the 
changeover from TDMA to CDMA is transparent to users. 

Hybrid cellular communications networks, incorporating both GSM and 
CDMA elements, are also described in PCT patent publications WO 95/24771 
and WO 96/21999, and in an article by Tscha, et al., entitled "A Subscriber 

20 Signaling Gateway between CDMA Mobile Station and GSM Mobile Switching 
Center," in Proceedings of the 2nd International Conference on Universal 
Personal Communications, Ottawa (1993), pp. 181-185, which are incorporated 
herein by reference. None of these publications deal with issues of support of 
short message or cell broadcast services, such as SMSCB, in such hybrid 

25 networks. 

SUMMARY OF THE INVENTION 

It is an object of the present invention to provide methods and apparatus 
30 for use in a mixed GSM /CDMA cellular communications network. 

It is a further object of some aspects of the present invention to provide 
methods and apparatus enabling realization of GSM Cell Broadcast Service over 
a CDMA air interface. 

In preferred embodiments of the present invention, a mixed 
35 GSM/CDMA cellular communications system includes both TDMA and CDMA 
base stations (BSSs), which are in contact with a Cell Broadcast Center (CBC) 
based on GSM standards. Systems of this type are described generally in U.S. 
patent application serial no. 09/119,717 entitled "Base Station Handover in a 
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Hybrid GSM/CDMA Network/' U.S. Patent Application Serial No. 09/119,717, 
filed July 20, 1998, which is assigned to the assignee of the present patent 
application and is incorporated herein by reference. A subscriber unit in the 
network, referred to herein as a mobile station (MS), is preferably capable of 
5 communicating with both types of base stations by appropriately switching 
between TDMA add CDMA air interfaces. GSM network protocols are used over 
both types of air interface, so that the MS receives short messages broadcast from 
the GSM CBC whether the MS is in communication with a TDMA BSS or a 
CDMA BSS. The present invention thus enables CDMA BSSs and MSs to be 

10 integrated into a GSM network infrastructure without compromising the ability 
of the CBC associated with the network to broadcast messages based on GSM 
standards to substantially any MS, and with substantially no other modification 
required to existing infrastructure. 

In some preferred embodiments of the present invention, GSM short 

15 message service - cell broadcast (SMSCB) messages are broadcast to the MS over 
the CDMA air interface using a CDMA paging channel. Preferably, the 
messages are broadcast in accordance with broadcast procedures over paging 
channels defined by the IS-95B standard. 

There is therefore provided, in accordance with a preferred embodiment 

20 of the present invention, in a GSM mobile wireless telecommunications system a 
method for broadcasting messages over a CDMA air interface, including: 

conveying a message to a base station substantially in accordance with a 
GSM cell broadcast service protocol; and 

transmitting the message to a mobile station over the CDMA air 

25 interface. 

Preferably, transmitting the message includes transmitting a message 
substantially in accordance with a CDMA transmission standard, most 
preferably IS95B. 

Preferably, transmitting the message includes transmitting a message 
30 over a paging channel, wherein transmitting the message includes directing the 
message to one or more specified cells. 

In a preferred embodiment, transmitting the message includes 
transmitting a message so as to have a high likelihood of being received by the 
mobile station while the mobile station is operating in a slotted mode, most 
35 preferably by transmitting a broadcast page followed by transmission of a 
message. Preferably, transmitting the broadcast page includes transmitting a 
page in a predetermined slot monitored by the mobile station in a periodic 
broadcast paging cycle. Optionally, the method includes transmitting a schedule 
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message including information regarding one or more broadcast pages to be 
transmitted in a schedule period including one or more periodic broadcast 
paging cycles. 

Preferably, transmitting the message includes transmitting a single 
5 message multiple times, substantially in accordance with a GSM cell broadcast 
command, wherein transmitting the single message includes assigning a 
broadcast address to the message, such that when the mobile station receives a 
second message having the same broadcast address as a first, earlier message, 
the second message is discarded. Preferably, transmitting the single message 
10 multiple times includes repeating transmission of the message at a repetition 
frequency determined responsive to the cell broadcast command. 

Further preferably, transmitting the message includes encapsulating a 
GSM cell broadcast message in an IS-95 message. 

Preferably, conveying the message includes receiving a message from a 
15 cell broadcast center. 

In a preferred embodiment, transmitting the message includes 
transmitting a message header including a message identifier field indicative of 
a characteristic of the message, and the mobile station determines whether to 
decode or discard the message responsive to the characteristic. 
20 There is also provided, in accordance with a preferred embodiment of 

the present invention, apparatus for broadcasting short messages from a cell 
broadcast center over a CDMA air interface, including a base station subsystem, 
which receives the messages from the cell broadcast center substantially in 
accordance with a GSM cell broadcast service protocol and transmits the 
25 message to a mobile station over the CDMA air interface. 

Preferably, the base station subsystem transmits the message 
substantially in accordance with a CDMA transmission standard, most 
preferably IS-95B. 

Preferably, the base station subsystem transmits the message over a 
30 paging channel and directs the message to one or more specified cells. 

Preferably, the base station subsystem transmits the message so as to 
have a high likelihood of being received by the mobile station while the mobile 
station is operating in a slotted mode, wherein before transmitting the message, 
the base station subsystem transmits a page in a predetermined slot monitored 
35 by the mobile station in a periodic broadcast paging cycle. 

Further preferably, the base station subsystem transmits a single message 
multiple times, substantially in accordance with a GSM cell broadcast command, 
wherein the base station subsystem repeats transmission of the message at a 
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repetition frequency determined responsive to the cell broadcast command. 
Further preferably, the base station subsystem assigns a broadcast address to the 
message, such that when the mobile station receives a second message having 
the same broadcast address as a first, earlier message, the second message is 
5 discarded. 

BRIEF DESCRIPTION OF THE DRAWINGS 

The present invention will be more fully understood from the following 
10 detailed description of the preferred embodiments thereof, taken together with 
the drawings in which: 

Fig. 1 is a schematic block diagram of a hybrid GSM/CDMA cellular 
communications system, in accordance with a preferred embodiment of the 
15 present invention; 

Fig. 2 is a schematic block diagram illustrating communications protocols 
between elements of the system of Fig. 1, in accordance with a preferred 
embodiment of the present invention; and 

Fig. 3 is a schematic block diagram illustrating a message format for use 
20 in cell broadcast service messages, in accordance with a preferred embodiment 
of the present invention. 

DETAILED DESCRIPTION OF PREFERRED EMBODIMENTS 

25 Reference is now made to Fig. 1, which is a schematic block diagram of a 

hybrid GSIVI/CDMA cellular communications system 20, in accordance with a 
preferred embodiment of the present invention. System 20 is built around a 
public land mobile network (PLMN) 22, which is based on the GSM 
communications standard, as is known in the art and described briefly 

30 hereinabove. Infrastructure for such networks already exists and is in wide use 
in many countries, and the present invention has the advantage of enabling 
gradual introduction of CDMA service in conjunction with such a network 
without requiring major changes to the existing switching infrastructure. 

PLMN 22 comprises at least one mobile-services switching center (MSC) 

35 24, or possibly a number of such centers (although only one MSC is shown here 
for clarity of illustration), which controls network operations within a 
geographical area. Among other functions, MSC 24 is responsible for location 
registration of subscriber units and handover of subscriber units between base 
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stations, as well as linking PLMN 22 to a public switched telephone network 
(PSTN) and /or packet data network (PDN) 48. The PLMN also comprises a 
network management center (NMC) 26 and a cell broadcast center (CBC) 28. 
Other aspects of system 20 and details regarding a mobile station (MS) 40 in the 
5 system, are described further in the above-mentioned U.S. and PCT Patent 
Applications. 

System 20 includes a plurality of MSs 40, which communicate with 
PLMN 22 via a plurality of base station subsystems (BSS) 30 and 32 over a 
wireless RF link at one or more of the accepted cellular communications 

10 frequencies. MS 40, which is also known as a subscriber unit, is preferably 
capable of communicating with both GSM BSS 30, using a standard GSM TDMA 
radio communications protocol, and CDMA BSS 32, using CDMA-based 
communication methods described hereinbelow. Although for the sake of 
clarity, only one each of MS 40, GSM BSS 30 and CDMA BSS 32 is shown in Fig. 

15 1, it will be understood that in actuality, system 20 typically comprises a 
plurality of each of these system elements. 

Communications between CDMA BSS 32 and MS 40 use a CDMA radio 
"air interface," which is preferably based on the IS-95 standard for CDMA 
communications, and most preferably with the TIA/EIA-95-B version of the 

20 standard, which is incorporated herein by reference, with necessary 
modifications as described herein. BSS 32 is built around a base station controller 
(BSC) 34, which controls and communicates with a number of base station 
transceivers (BTS) 36. Each BTS transmits RF signals to and receives RF signals 
from MS 40 when the MS is within a geographical area, or cell, served by the 

25 particular BTS. On the other hand, when MS 40 is within a cell served by GSM 
BSS 30, the MS preferably communicates with BSS 30 over a GSM/TDMA air 
interface to GSM/TDMA BTSs (not shown in the figure for the sake of 
simplicity). 

Both GSM BSS 30 and CDMA BSS 32 communicate with and are 
30 controlled by MSC 24, substantially in accordance with GSM standards, i.e., via 

the GSM standard A-interface, as further described in the above-mentioned U.S. 

and PCT Patent Applications. BSS 32 also comprises a radio operation and 

maintenance center (OMCR) 38, which communicates with NMC 26 over a GSM- 

standard Q3 interface. 
35 BSC 34 communicates with CBC 28 so as to receive short messages to be 

broadcast over the air, based on the above-mentioned GSM SMSCB standards. 

One CBC 28 is typically connected to BSCs of a plurality of BSSs, which may 

include both CDMA BSSs, such as BSS 32, and GSM/TDMA BSSs, such as BSS 
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30. The CBC may receive short messages for broadcast from several cell 
broadcast entities (not shown), such as weather and traffic report centers, as 
described in GSM specifications, 

CBC 28 is responsible for management of cell broadcast short messages 
and issuing commands to BSC 34 (and other BSCs), including: 

• Allocation of serial numbers for identification of messages, as specified 
by GSM standard 03.41. The serial number is included in the header of 
each message (described further hereinbelow with reference to Fig. 3). It 
typically includes fields specifying a geographical scope of the message, 
a message code for differentiating between messages from the same 
source and of the same type, and an update number. 

• Modifying or deleting messages held by the BSC. 

• Initiating broadcast by sending cell broadcast messages to the BSC, and 
where necessary padding the messages to a length of 82 octets, based on 
GSM standard 03.41. 

• Determining a set of cells or BTSs to which the message should be 
broadcast and indicating the geographical scope of the message. A list of 
the determined cells or BTSs is conveyed to the BSC, which then 
distributes the broadcast accordingly. 

• Determining a time at which the message should commence being 
broadcast. 

• Determining a time at which the message should cease being 
broadcast, and instructing the BSC accordingly, 

• Determining a rate at which the message broadcast should be repeated. 

• Determining the cell broadcast channel on which the message should 
be broadcast. 

BSC 34 performs the following function vis-a-vis CBC 28: 

• Receiving and interpreting cell broadcast commands. 

• Storing cell broadcast messages. 

• Scheduling of the messages over CDMA paging channels, as described 
further hereinbelow. 

• Providing an indication to the CBC when the desired message 
repetition rate cannot be achieved, for example, when the desired rate is 
too high. 

• Acknowledging successful execution of CBC commands. 

• Reporting to the CBC when a command cannot be understood or 
cannot be executed. 
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• Routing ceil broadcast messages to the appropriate BTSs, preferably- 
using directed paging procedures, as described further hereinbelow. 

• Transferring cell broadcast service (CBS) information to each BTS. 

• Optionally, generating schedule messages, as described further 
5 hereinbelow, indicating an intended schedule of transmissions. 

Preferably, when a message conveyed from BSC 34 to CBC 28 pertains to 
multiple cells, the message is conveyed only once, together with a list of the cells 
to which it applies. 

10 MS 40 comprises mobile equipment (ME) 42, w r hich preferably includes 

either two radio transceivers, one configured for TDMA operation and one for 
CDMA, or a single transceiver which can dynamically switch between TDMA 
and CDMA. The MS includes mobile termination (MT), which supports terminal 
equipment (TE) 46 for voice and data input and output. In addition, MS 40 

15 comprises a subscriber identity module (SIM) 44, in accordance with GSM 
standards, which is used in authenticating the identity of a user of MS 40 in a 
manner substantially transparent to and independent of the CDMA air interface. 
Although preferred embodiments are described herein with reference to MS 40 
having dual CDMA/TDMA air interface compatibility, it will be understood 

20 that the principles of the present invention may similarly be applied to systems 
using mobile stations having only CDMA compatibility or, mutatis mutandis, to 
other systems using GSM networking standards, 

MS 40 receives the cell broadcast messages transmitted by BTS 36 from 
BSC 34. Typically, TE 46 is used to display the messages in alphanumeric format, 

25 as is known in the art. In addition, MS 40 has the following capabilities with 
regard to the 25 cell broadcast messages: 

• Identifying and discarding messages that have a message identifier 
indicating that the subject matter of the message is not of interest to a 
subscriber using the MS. 

30 • Ignoring repeated broadcast of messages already received (i.e., a 

message broadcast address has not changed). 

• Transferring the message via a R-interface between ME 42 and TE 46, 
when such an interface is supported. 

35 Reference is now made to Fig. 2, which is a schematic block diagram 

showing protocol stacks used in conveying SMSCB teleservice messages 
between CBC 28 and MS 40 via BSS 32, in accordance with a preferred 
embodiment of the present invention. The protocols shown in the figure enables 

SUBSTITUTE SHEET (RULE 26) 



WO 01/10146 



PCT/US00/21065 



9 

the substantially unmodified GSM CBC to convey short messages to MS 40, 
based on GSM SMSCB standards, using paging channel broadcast procedures 
between the BSS and the MS specified by the IS95B standard. 

Cell broadcast messages are conveyed from CBC 28 to BSC 34 over a 
CBC-BSC interface, which is generally in accordance with GSM specifications. 
As noted hereinabove, the protocol to be implemented in this interface is a 
mattter to be agreed upon between operators of the CBC and PLMN 22, based 
on primitives defined in GSM standard 03.41. Preferably, as illustrated in Fig. 2, 
the stack is in accordance with one of the sample protocol stacks provided in 
GSM standard 03.49. 

The GSM primitives defined by the 03.41 standard are generally received 
and interpreted by BSC 34 in conformity with the standard, but there are a few 
exceptions necessitated in order to accommodate IS-95B broadcast procedures 
over the paging channel. GSM standards support two kinds of cell broadcast 
channels (CBCH): a basic and an extended channel; but both of these channels 
are mapped to the same CDMA paging channel. Furthermore, whereas GSM 
specifications define the maximum 20 repetition frequency of a cell broadcast 
message as once in every 51 x 8 TDMA frames (1.883 sec), the maximum 
repetition frequency over the CDMA air interface, in accordance with IS-95B, is 
once in every periodic broadcast paging cycle, corresponding to about 2.8 sec at 
a minimum. BSS 32 determines a BCAST_INDEX parameter between 1 and 7, as 
specified by IS-95B, to set the duration of the periodic broadcast paging cycles. In 
the event of a conflict, such as more than one message to broadcast at a given 
time, BSS 32 determines the order of broadcast of the messages in accordance 
with predetermined criteria. 

BSS 32 manages end-to-end delivery of the messages and provides 
synchronization and scheduling services based on the interface primitives used 
in the CBC-BSC interface. IS-95B includes several different paging methods, 
which are applicable in corresponding preferred embodiments of the present 
intention and are described further hereinbelow. Preferably, BSC 34 is capable of 
sending broadcast pages (as described hereinbelow) and messages to specific 
cells, so that the cell broadcast messages can be distributed to specified 
geographical areas. 

MS 40 exchanges signals with CDMA BSS 32 over a CDMA Urn interface, 
wherein the MS and BSS protocol stacks are modified to accommodate GSM 
network services, such as SMSCB, as described herein. The SMSCB messages are 
transmitted from BTS 36 to MS 40 over the paging channel of the CDMA air 
interface. 
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Fig. 3 is a block diagram illustrating a SMSCB message 80 transmitted 
over the paging channel to MS 40, in accordance with a preferred embodiment of 
the present invention. Message 80 has the form of a standard IS-95 Data Burst 
Message (DBM), Message 80 encapsulates an entire GSM cell broadcast message, 
5 including a GSM SMSCB header 86 and data 88, preferably in accordance with 
GSM standard 03.41. Message 80 also includes a MSG LEN field 82, set by BSS 32 
to specify the total length of the message, and a CRC field 92, both in accordance 
with IS-95 specifications, along with a DBM header 84 and a reserved field 90 of 
5 bits. 

10 DBM header 84 is set by BSS 32 to be generally in accordance with IS-95B 

specifications for paging channel messages, with the exception of a broadcast 
address field in the DBM header, whose content is preferably set to 
accommodate GSM cell broadcast service, as defined in particular by GSM 
standard 03.41, section 9.3, "Message Format on BTS-MS interface." The 

15 broadcast address field contains a part of a cell broadcast message header 
generated by CBC 28, which uniquely identifies the message so that MS 40 can 
detect and avoid decoding messages that it has already received or which are 
not of interest to the subscriber. (The CBC message header includes the first six 
octets of the 88 octets of the complete message.) MS 40 ignores messages whose 

20 BURST_TYPE and broadcast address fields in DBM header 84 are identical to 
those of an earlier message already received in a given periodic broadcast slot 
cycle. 

The structure of the broadcast address field is illustrated in Table I 

25 below: 



TABLE I 



Sub-Field 


Length 
(bits) 


Value 


Message Type 


8 


0 - normal message 

1 - schedule message (as described further 
hereinbelow) 

Other - reserved 


Serial Number 


16 


For any given Message Identifier, the Serial 
Number is updated every time a new message 
is transmitted, to distinguish different messages 
with a common source and type. 
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Message 
Identifier 


16 


Identifies the source and type of the message. 


11^+^ inn ino - 
Lya La V_V>U-lllti 

Scheme 


Q 
O 


Indicates intended handling of the message at the 
MS, including alphabet/ coding and language as 
defined by GSM standard 03.38. 



The structure of the Serial Number sub-field is also defined in 
accordance with the above-mentioned section 9.3 of GSM standard 03.41, and is 
illustrated in Table II below: 

5 

TABLE II 



Sub-Field 


Length 
(bits) 


Value 


Geographical 
Scope 


2 


Indicates a geographical area over which the 
Message Code is unique, as well as the display 
mode. 


Message Code 


10 


Varied so as to differentiate between messages 
from the same source and of the same type 
(i.e., having same Message Identifier). 


Update 
Number 


4 


Indicates a change of message content for a given 
Message Identifier, Geographical Scope and 
Message Code. 



Message Codes are allocated by PLMN operators and can be used to 
identify different message themes. 

10 

Because a given message is not necessarily broadcast by all cells within a 
given geographical area, the Geographical Scope may be used to determine 
whether two messages having identical Serial Numbers and Message Identifiers 
that are received in different cells are indeed identical, as described in the 
15 above-mentioned section 9.3 of the GSM 03.41 standard. 

Typically, MS 40 operates in a slotted mode, as specified by IS-95B, and 
does not constantly monitor a paging channel. Therefore, in transmitting a cell 
broadcast message, special procedures are preferably used to ensure that MSs 
operating in the slotted mode are able to receive the message. 
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Thus, in a preferred embodiment of the present invention, BSS 32 
transmits a broadcast page message, such as a General Page Message, as 
specified by IS-95B, or a Paging Request Message, based on GSM standards, or 
another suitable message type, announcing the impending transmission of a 
broadcast message. A page record included in the page message (which 
normally specifies an identification of the MS to which the message is 
addressed) preferably contains a broadcast address, indicating to MSs receiving 
the page message when a cell broadcast message is to be transmitted. The actual 
cell broadcast message is then transmitted once. When one of the MSs decodes 
the broadcast address in the page record, it can determine whether the broadcast 
message is a duplicate of a message already received or is not of interest to the 
subscriber and, if so, will avoid decoding the broadcast message itself. 

In another preferred embodiment, BSS 32 uses a periodic broadcast 
paging cycle, in accordance with the IS-95B specification, so as to reduce 
overhead required for sending broadcast messages. In this mode of operation, 
MS 40 monitors the paging channel during a predetermined slot in which 
broadcast pages or messages are transmitted, so that the pages and messages 
need be transmitted only once during each periodic broadcast paging cycle. 
Preferably, the broadcast page is sent in the first slot of a given cycle, which is 
monitored by the MS, and the broadcast message itself is transmitted later, in 
accordance with IS-95B. 

Preferably, broadcast message scheduling, generally as described in the 
GSM 03.41 standard, is used in distributing cell broadcast messages to MSs 
operating in slotted mode. In this case, the broadcast page message comprises a 
Schedule Message, in which the Message Type field (noted in Table I) inset to '1'. 
The Schedule Message contains information about a number of consecutive cell 
broadcast messages that will be transmitted during a Schedule Period, consisting 
of one or more periodic broadcast cycles, immediately thereafter. The Schedule 
Message includes a Message Description for each of the messages, along with a 
cycle number indicating its time position in the Schedule Period. The Message 
Description contains information from the broadcast address, so that MSs can 
ascertain the type and source of each scheduled message and whether it has 
already received the message. 

Each Schedule Message includes fields defining a Begin Cycle Number 
and an End Cycle Number, indicating the length of the Schedule Period. 
Preferably, a new Schedule Message is transmitted following the last message of 
the Schedule Period, i.e., in a cycle given by the preceding End Cycle Number + 
1. Several Schedule Messages can be broadcast in reference to the same Schedule 
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Period, and the Begin Cycle Number indicates the first cycle immediately 
following the last Schedule Message. 

When necessary, the BSS may receive instructions to override the 
schedule published in the Schedule Message, for example, to transmit a new, 
5 high-priority SMSCB message. Thereafter, the previous schedule of cell 
broadcast messages is resumed. 

The methods and protocols described hereinabove apply when MS 40 is 
in communication with CDMA BSS 32. When MS 40 is in communication with 
CBC 28 via GSM BSS 30, the communications protocols between these elements 

10 are in accordance with GSM standards, substantially without modification. 

Although preferred embodiments are described hereinabove with 
reference to specific TDMA- and CDMA-based communications standards, those 
skilled in the art will appreciate that the methods and principles described 
hereinabove may also be used in conjunction with other methods of data 

15 encoding and signal modulation. The scope of the present invention 
encompasses not only the complete systems and communications processes 
described hereinabove, but also various innovative elements of these systems 
and processes, as well as combinations and sub-combinations thereof. In 
particular, although preferred embodiments are described hereinabove with 

20 reference to hybrid TDMA/CDMA system 20 and MS 40, it will be understood 
that the methods and apparatus described may equally be used to convey cell 
broadcast messages to a MS in a CDMA system without TDMA capabilities. 

It will thus be appreciated that the preferred embodiments described 
above are cited by way of example, and the full scope of the invention is limited 

25 only by the claims. 



WE CLAIM: 
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CLAIMS 

1. In a GSM mobile wireless telecommunications system, a method for 
2 broadcasting messages over a CDMA air interface, comprising: 

conveying a message to a base station substantially in accordance with a 
4 GSM cell broadcast service protocol; and 

transmitting the message to a mobile station over the CDMA air 
6 interface. 

2. A method according to claim 1, wherein transmitting the message 
2 comprises transmitting a message substantially in accordance with a CDMA 

transmission standard. 

3. A method according to claim 2, wherein the CDMA transmission 
2 standard comprises IS-95B. 

4. A method according to claim 2, wherein transmitting the message 
2 comprises encapsulating a GSM cell broadcast message in an IS-95 message. 

5. A method according to claim 1, wherein transmitting the message 
2 comprises transmitting a message over a paging channel. 

6. A method according to claim 5, wherein transmitting the message 
2 comprises directing the message to one or more specified cells. 

7. A method according to claim 5, wherein transmitting the message 
2 comprises transmitting a message so as to have a high likelihood of being 

received by the mobile station while the mobile station is operating in a slotted 
4 mode. 

8. A method according to claim 7, wherein transmitting the message 
2 comprises transmitting a broadcast page followed by transmission of a message. 

9. A method according to claim 8, wherein transmitting the broadcast page 
2 comprises transmitting a page in a predetermined slot monitored by the mobile 

station in a periodic broadcast paging cycle. 
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10. A method according to claim 9, and comprising transmitting a schedule 
2 message including information regarding one or more broadcast pages to be 

transmitted in a schedule period comprising one or more periodic broadcast 
4 paging cycles. 

11. A method according to claim 1, wherein transmitting the message 
2 comprises transmitting a single message multiple times, substantially in 

accordance with a GSM cell broadcast command. 

12. A method according to claim 11, wherein transmitting the single 
2 message comprises assigning a broadcast address to the message, such that 

when the mobile station receives a second message having the same broadcast 
4 address as a first, earlier message, the second message is discarded. 

13. A method according to claim 11, wherein transmitting the single 
2 message multiple times comprises repeating transmission of the message at a 

repetition frequency determined responsive to the cell broadcast command. 

14. A method according to claim 1, wherein conveying the message 
2 comprises receiving a message from a cell broadcast center. 

15. A method according to claim 1, wherein transmitting the message 
2 comprises transmitting a message header including a message identifier field 

indicative of a characteristic of the message, and wherein the mobile station 
4 determines whether to decode or discard the message responsive to the 
characteristic. 

16. Apparatus for broadcasting short messages from a cell broadcast center 
2 over a CDMA air interface, comprising a base station subsystem, which receives 

the messages from the cell broadcast center substantially in accordance with a 
4 GSM cell broadcast service protocol and transmits the message to a mobile 
station over the CDMA air interface. 

17. Apparatus according to claim 16, wherein the base station subsystem 
2 transmits the message substantially in accordance with a CDMA transmission 

standard. 



SUBSTITUTE SHEET (RULE 26) 



WO 01/10146 



16 



PCT/US00/21065 



18. Apparatus according to claim 17, wherein the CDMA transmission 
2 standard comprises IS-95B. 

19. Apparatus according to claim 17, wherein the base station encapsulates a 
2 GSM cell broadcast message in an IS-95 message. 

20. Apparatus according to claim 16, wherein the base station subsystem 
2 transmits the message over a paging channel. 

21. Apparatus according to claim 16, wherein the base station subsystem 
2 directs the message to one or more specified cells. 

22. Apparatus according to claim 16, wherein the base station subsystem 
2 transmits the message so as to have a high likelihood of being received by the 

mobile station while the mobile station is operating in a slotted mode. 

23. Apparatus according to claim 22, wherein before transmitting the 
2 message, the base station subsystem transmits a page in a predetermined slot 

monitored by the mobile station in a periodic broadcast paging cycle. 

24. Apparatus according to claim 16, wherein the base station subsystem 
2 transmits a single message multiple times, substantially in accordance with a 

GSM cell broadcast command. 

25. Apparatus according to claim 24, wherein the base station subsystem 
2 repeats transmission of the message at a repetition frequency determined 

responsive to the cell broadcast command. 

26. Apparatus according to claim 24, wherein the base station subsystem 
2 assigns a broadcast address to the message, such that when the mobile station 

receives a second message having the same broadcast address as a first, earlier 
4 message, the second message is discarded. 
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